Settings
Settings — Systems › Settings — is a hub of five configuration cards covering localisation, vouchers/topup, server/network behaviour, scheduled task timing, and (superuser only) outgoing mail. Each card opens its own offcanvas panel and saves independently.
'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}public/assets/img/docs/settings/overview.png
General
Localisation defaults and account-security behaviour for the tenant.
| Setting | Description |
|---|---|
| Default Currency | ISO 4217 currency code, e.g. MYR, USD, EUR. |
| GST/VAT Rate (%) | Tax rate applied to billing. Set 0 if not applicable. |
| Data Transfer Reporting Metric | Unit for data transfer display, e.g. Mb, Gb. |
| Time Zone | Default timezone used for reports and scheduling. All cron times on the Cron Timing card are entered and displayed in this timezone. |
| Date Format | Display format for dates across the admin panel. |
| Forgot Password Method | Channel used to send password reset instructions — email or sms. |
| Forgot Password Template | Message template used for the reset notification. |
| Clear password change date on reset | The password change date will be cleared whenever the account is reset. |
| Ask User for Web Push | Only works if the connection is HTTPS and the end user is on Android or Windows (Chrome or Firefox). |
| 2-Factor Authentication | For administrators only — this toggle does not affect guest WiFi user login. |
Requires the manage-settings-general permission.
Voucher & Topup
Voucher code format and topup behaviour.
| Setting | Description |
|---|---|
| Voucher Default Prefix | Characters prepended to every generated voucher code. |
| Voucher Format | Algorithm used to generate voucher codes: sequence, unique_id, or random. |
| Voucher Template | Layout template for printed voucher cards, chosen from your message templates. |
| Voucher Random Length Limit | Shorter voucher usernames can overlap and limit the number of available names — only shown when Voucher Format is random. |
| Prevent Ambiguous Characters | Excludes visually similar characters (0/O, 1/I/l) when generating random voucher codes. |
| Topup Default Prefix | Characters prepended to every generated topup code. |
| Allow Topup via Voucher | Allow users to top up using voucher codes. |
| Topup Carry Forward | Unused quota carries over to the next billing cycle. |
| Allow Topup via Account | Allow users to top up directly from their account. |
Requires the manage-settings-prefix permission.
Server Configuration
RADIUS accounting intervals, network redirection, and one system-level toggle.
| Setting | Description |
|---|---|
| Accounting Interim Interval — Free Profile | Interval (in seconds) for RADIUS accounting updates on free profiles. Minimum 60s. |
| Accounting Interim Interval — Non-Free Profile | Interval (in seconds) for RADIUS accounting updates on paid profiles. Minimum 60s. |
| DNS/IP Server for Redirection | DNS or IP address used for captive portal redirection. |
| URL for Captive Network Trigger | URL endpoint that triggers captive-portal detection on guest devices. |
| Use IP Address as Tenant | Resolve tenant identity using the client IP address. |
Setting either accounting interval below 300 seconds may increase RADIUS server load significantly across all active sessions.
Requires the manage-settings-server permission.
Cron Timing
Scheduled task times, entered in the tenant's Time Zone and converted to/from UTC for storage. Grouped into three sections:
| Section | Fields |
|---|---|
| Scheduled Tasks | System update check, campaign last-visit evaluation, daily backup, admin statistics email, user statistics email — each a time-of-day; plus device monitor interval and notification interval, both in minutes. |
| Profile Reset Schedule | Daily / weekly / monthly / yearly profile quota reset times. |
| Account Policy Schedule | Daily / weekly (with day-of-week selector) / monthly / yearly account policy run times. |
Changing your Time Zone on the General card shifts what these local times mean in UTC — reset any cron time here after a timezone change if the schedule needs to keep firing at the same wall-clock time.
Requires the manage-settings-cron permission.
SMTP (superuser only)
Read-only display of the outgoing mail server, synced from your license — host, port, username, password (masked), and encryption, plus a sender identity (from address / from name). Not editable here; a Send Test Email action confirms the current configuration is deliverable.
Visible only when logged in as superuser.
Required Permissions
manage-settings-general · manage-settings-prefix · manage-settings-server · manage-settings-cron
Each card is independently gated — an admin without a given permission sees a "not permitted" placeholder in that card's panel instead of the form. The SMTP card has no separate permission; it is shown only to superusers.