WifiCone Help

System Management

The System section covers software updates, backups, scheduled tasks, logs, and user account management.


Software Updates

Go to Admin Panel → System → Updates.

WifiCone checks for updates automatically every 5 minutes using a systemd timer. Updates are applied during the maintenance window (3:00 AM by default).

Manual Update

Click Check for Updates to fetch the latest version immediately.

If a new version is available:

  1. The service is stopped briefly.
  2. The new binary is installed.
  3. The service restarts.
  4. If the new version fails health checks, it automatically rolls back to the previous binary.

Force Update Now

To trigger an update outside the maintenance window:

sudo touch /var/run/wificone-update-pending

The next timer run (within 5 minutes) will process the update.


Backup & Restore

Go to System → Backup.

What Is Backed Up

  • Rate profiles and session settings
  • Voucher database
  • Sales history
  • Network configuration
  • Payment portal settings
  • Admin user accounts

Creating a Backup

Click Create Backup — a .zip file is downloaded to your browser.

Restoring a Backup

  1. Click Restore from Backup.
  2. Select the backup .zip file.
  3. Confirm — the system restores all settings and restarts the service.

Restoring a backup overwrites current settings. Export your current state first if needed.


System Logs

Go to System → Logs to view live and recent log entries from the WifiCone service.

Log entries are also available via:

sudo journalctl -u wificone -f         # live logs
sudo journalctl -u wificone -n 100     # last 100 lines
sudo journalctl -u wificone-updater    # update logs

Scheduled Tasks (Cron)

Go to System → Cron to manage scheduled jobs:

Task Default Schedule Description
Expire old sessions Every 5 min Clears expired sessions from the database
Sales archive Daily at midnight Archives old sales records
DB cleanup Weekly Vacuums the database to free space

You can add custom cron jobs from the admin panel — useful for scheduled reports or custom scripts.


Database Management

Go to System → Database:

Action Description
Vacuum Reclaim unused database space (run after clearing large datasets)
Reset Clear all data and return to factory defaults (irreversible)
Export SQL Download a full SQL dump of the database
Run Migration Apply any pending database schema migrations

Database Reset permanently deletes all vouchers, sales, sessions, and settings. Only use this for a full factory reset.


Admin Users

Go to System → Users to manage who can access the admin panel:

Action Description
Add User Create a new admin account with a username and password
Edit Change username, password, or permissions
Delete Remove an admin account
Permissions Control which sections each user can access

There is always one super-admin account (the admin user created at install) that cannot be deleted.


Time & NTP

Go to System → Time:

Setting Description
Timezone Set the device's local timezone (important for the midnight sales reset and maintenance window)
NTP Server Primary NTP server for time synchronization (default: pool.ntp.org)
Sync Now Manually trigger an NTP sync

Incorrect timezone causes the daily sales reset to happen at the wrong time and can affect scheduled updates.


Migration Tools

Go to System → Migration to import data from another WifiCone device or an older installation:

  • Import voucher batches
  • Import rate profiles
  • Import sales history

Next Steps