WifiCone Help
wificone.com My Account

Installation

WifiCone installs on any 64-bit or ARM Linux device with a single command. The installer handles PostgreSQL, nginx, and the systemd service automatically.

Requirements

Item Minimum
OS Debian 12 or Ubuntu 22.04 LTS (or later)
Architecture x64 (amd64), arm64, or armv7
RAM 512 MB
Storage 2 GB free
Internet Required during install (for package downloads)

Supported Architectures

Arch Example Hardware
x64 PC, mini PC, Intel NUC, any 64-bit desktop/laptop
arm64 Raspberry Pi 4/5, Orange Pi, most modern SBCs
armv7 Raspberry Pi 2/3, older ARM boards

Install Command

Run as root on your device:

bash <(curl -fsSL https://raw.githubusercontent.com/wificone/wfc-release/main/install.sh)

The installer will:

  1. Detect your CPU architecture
  2. Install system packages (nginx, postgresql, git, curl)
  3. Clone the WifiCone release to /opt/wificone
  4. Set up the PostgreSQL database and generate a secure password
  5. Create the wificone system user
  6. Configure nginx as a reverse proxy on port 80
  7. Install the wificone.service and wificone-updater.timer systemd services
  8. Start the service

Total install time: 2–5 minutes depending on internet speed.

What Gets Installed

Path Description
/usr/local/bin/wificone The WifiCone binary
/opt/wificone/ Release files (config defaults, public assets)
/etc/wificone/ Configuration directory
/etc/wificone/db.env Database credentials (chmod 600)
/etc/wificone/arch Detected architecture (used by auto-updater)
/var/lib/wificone/ Runtime data directory
/etc/nginx/sites-available/wificone nginx proxy config
/etc/systemd/system/wificone.service Main service unit
/etc/systemd/system/wificone-updater.timer Auto-update timer (every 5 min)

After Install

Once the installer finishes, open a browser and go to:

http://<your-device-ip>/admin/login.html

Default credentials:

Field Value
Username admin
Password admin

Change the default password immediately — go to Admin → Profile after first login.

Updating

WifiCone auto-updates every night at 3:00 AM by default. To update immediately:

sudo bash /opt/wificone/update.sh

Or set a flag file to trigger an update on the next timer run:

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

Checking Service Status

# Is the service running?
sudo systemctl status wificone

# View live logs
sudo journalctl -u wificone -f

# Restart the service
sudo systemctl restart wificone

Next Steps