System
Settings
Settings is the global configuration page for the tenant — controlling system behaviour, appearance, account defaults, email behaviour, and security policies. Changes take effect immediately unless noted.
'alt' => 'Dashboard overview', 'caption' => 'The default Kiwire dashboard layout', 'screenshot' => true, 'class' => '', ]) Drop images into: public/assets/img/docs/{page}/{filename} --}}
Image not uploaded yet
public/assets/img/docs/settings/overview.png
General Settings
| Setting | Description |
|---|---|
| Tenant Name | The display name of your organisation shown in the admin header and email templates. |
| Timezone | All dates, times, and schedules are interpreted and displayed in this timezone. |
| Date Format | How dates are displayed across the panel (e.g., d/m/Y, Y-m-d). |
| Language / Locale | Default language for the admin panel. Supported: English, Malay, Spanish, Indonesian, Chinese (Simplified). |
| WiFi Logo | Logo image displayed on the captive portal login page. |
| Favicon | Browser tab icon for the captive portal. |
Portal Settings
| Setting | Description |
|---|---|
| Default Redirect URL | Where users are sent after a successful portal login. Can be overridden per journey. |
| Session Check Interval | How often (in seconds) the captive portal checks whether the user's session is still active. |
| Walled Garden IPs | IP addresses or CIDR ranges that are accessible before login (e.g., your payment gateway or social login endpoints). One entry per line. |
| Portal Domain (FQDN) | The fully-qualified domain name of the captive portal (e.g., wifi.example.com). Used to construct redirect URLs sent to APs. |
Account Settings
| Setting | Description |
|---|---|
| Default Password Expiry | Number of days after account creation before the WiFi user's password expires. Set to 0 to disable expiry. |
| Auto-Deactivation After Inactivity | Automatically deactivate user accounts that have not logged in for this many days. Set to 0 to disable. |
| Grace Period Default | Number of days after expiry that an account remains accessible before it is fully blocked. Applies to profiles that do not override this value. |
Email Settings
| Setting | Description |
|---|---|
| CC Address | An email address to CC on all outbound user emails (welcome, password reset, expiry reminder). Useful for compliance archiving. |
| Email Footer Text | Custom text appended to the footer of all emails sent to WiFi users. Typically contains the organisation name, address, and unsubscribe language. |
Security Settings
| Setting | Description |
|---|---|
| Maximum Failed Login Attempts | Number of consecutive failed admin login attempts before the account is locked. Default: 5. |
| Lockout Duration | How many minutes a locked account must wait before login is re-enabled. Default: 15 minutes. |
| Session Idle Timeout | Minutes of admin inactivity before the session is invalidated. Overrides the SESSION_IDLE_TIMEOUT environment variable if set here. Default: 30 minutes. |
| Force MFA for All Admins | When enabled, all admin accounts must enrol in MFA before they can access any page. Admins without MFA are redirected to the setup flow. |
Security settings under Login Config provide more granular control over password policy and session behaviour. The settings here are the tenant-level defaults; Login Config values take precedence where they overlap.
License
The License section at the bottom of Settings shows a read-only summary of the current license. To activate or update a license key, use the dedicated License module in the System menu.
| Field | Description |
|---|---|
| License Key | The activation key (partially masked for security). |
| Plan Type | Free, Starter, Professional, or Enterprise. |
| User Limit | Maximum number of WiFi user accounts permitted. |
| Expiry | License validity end date. A warning appears 30 days before expiry. |
Required Permissions
view-settings · update-settings