Skip to content

CLI Reference

Commands

CommandAliasDescription
devicesdManage adopted and pending devices
clientsclManage connected clients
networksnManage networks and VLANs
wifiwManage WiFi broadcasts (SSIDs)
firewallfwManage firewall policies and zones
aclManage ACL rules
dnsManage DNS policies (local records)
traffic-listsManage traffic matching lists
hotspotManage hotspot vouchers
vpnView VPN servers and tunnels
sitesManage sites
eventsView and stream events
alarmsManage alarms
statsQuery statistics and reports
systemsysSystem operations and info
adminAdministrator management
dpiDPI reference data
radiusView RADIUS profiles
wansView WAN interfaces
countriesList available country codes
configManage CLI configuration
completionsGenerate shell completions

Most commands support list, get, create, update, and delete subcommands. Run unifly <command> --help for details.

Devices

bash
unifly devices list                   # All adopted devices
unifly devices list --filter online   # Filter by status
unifly devices get <ID>               # Device details
unifly devices restart <ID>           # Restart a device
unifly devices upgrade <ID>           # Trigger firmware upgrade
unifly devices adopt <MAC>            # Adopt a pending device

Clients

bash
unifly clients list                   # Connected clients
unifly clients get <MAC>              # Client details
unifly clients block <MAC>            # Block a client
unifly clients unblock <MAC>          # Unblock a client
unifly clients reconnect <MAC>        # Force reconnection

Networks

bash
unifly networks list                  # All networks/VLANs
unifly networks get <ID>              # Network details
unifly networks create --name "IoT" --vlan 20 --subnet "10.0.20.0/24"
unifly networks update <ID> --dhcp-enabled true
unifly networks delete <ID>

WiFi

bash
unifly wifi list                      # All SSIDs
unifly wifi get <ID>                  # SSID details
unifly wifi create --name "Guest" --password "..."
unifly wifi update <ID> --enabled false
unifly wifi delete <ID>

Firewall

bash
unifly firewall policies              # List firewall policies
unifly firewall zones                 # List firewall zones
unifly firewall policies get <ID>     # Policy details

Events

bash
unifly events list                    # Recent events
unifly events stream                  # Live event feed
unifly events stream --severity warn  # Filter by severity

Statistics

bash
unifly stats gateway                  # Gateway bandwidth stats
unifly stats clients                  # Client count over time
unifly stats site                     # Site-level statistics

Time windows: 1h, 6h, 12h, 24h, 7d, 30d

bash
unifly stats gateway --window 24h

Configuration

bash
unifly config init                    # Interactive setup
unifly config profiles                # List profiles
unifly config use <PROFILE>           # Switch active profile
unifly config show                    # Show current config

Global Flags

-p, --profile <NAME>     Controller profile to use
-c, --controller <URL>   Controller URL (overrides profile)
-s, --site <SITE>        Site name or UUID
-o, --output <FORMAT>    Output: table, json, json-compact, yaml, plain
-k, --insecure           Accept self-signed TLS certificates
-v, --verbose            Increase verbosity (-v, -vv, -vvv)
-q, --quiet              Suppress non-error output
-y, --yes                Skip confirmation prompts
    --timeout <SECS>     Request timeout (default: 30)
    --color <MODE>       Color: auto, always, never
    --api-key <KEY>      Integration API key

Released under the Apache 2.0 License.