Skip to content

CLI Commands

Complete reference for tailscale-manager commands.

Usage

sh
tailscale-manager [command] [options]

Running without arguments opens the interactive menu.

Commands

Two independent kinds of "update"

  • update / auto-update act on the Tailscale binary (the VPN program this tool installs).
  • self-update acts on this manager (scripts, libraries, init/cron scripts, and enabled LuCI files).

They are completely independent: updating Tailscale never touches the manager, and self-update never touches Tailscale.

Core (Tailscale binary)

CommandDescription
installInteractive Tailscale installation
update [--yes]Update the Tailscale binary to the latest version (--yes skips the prompt)
rollbackRoll back the Tailscale binary to the previous version
uninstall [--yes]Remove Tailscale and all related files (--yes skips the prompt)
statusShow current installation and service status

Diagnostics & Troubleshooting

CommandDescription
logs [n] [--maskinfo]Show the last n lines of the manager, service, and system logs at once (default 200). --maskinfo hides addresses, MagicDNS names, emails, and optional custom regex matches
diagnostics [--maskinfo]Print a full troubleshooting report (versions, platform, install/runtime state, dependency checks, UCI config, and recent logs) ready to paste into an issue (alias: doctor)
sh
tailscale-manager diagnostics        # run this before opening an issue
tailscale-manager diagnostics --maskinfo
tailscale-manager logs 500           # show the last 500 log lines
tailscale-manager logs 500 --maskinfo='my-router-name'

Installation Variants

CommandDescription
install --yesNon-interactive installation (for LuCI/automation)
install-version <ver>Install a specific Tailscale version
download-onlyDownload binary without installing

Install Options

install --yes and install-version accept these flags:

FlagValuesDescription
--sourceofficial / smallDownload source
--storagepersistent / ramStorage mode (install --yes only)
--auto-update0 / 1Enable daily Tailscale auto-update cron (install --yes only)
--bin-dirabsolute pathCustom binary directory for persistent mode (see Storage Modes)
--luci0 / 1Install the optional LuCI web UI (install --yes only; default: 0)

Examples:

sh
tailscale-manager install --yes --source small --bin-dir /mnt/sda1/tailscale
tailscale-manager install --yes --source small --luci 1
tailscale-manager install-version 1.78.0 --bin-dir /mnt/sda1/tailscale

Version Management

CommandDescription
list-small-versions [n]List available Small binary versions (default: 10)
list-official-versions [n]List available Official versions (default: 20)

Network Configuration

CommandDescription
setup-subnet-routingConfigure tailscale0 interface and firewall zone
net-mode [auto|tun|userspace|status]Get or set networking mode

Tailscale auto-update

CommandDescription
auto-update [enable|disable|status]Manage the daily Tailscale binary auto-update cron job

(on/off/1/0 are still accepted as aliases for enable/disable.)

LuCI Web UI

CommandDescription
luci installInstall the optional LuCI web UI
luci removeRemove only the LuCI web UI files
luci statusShow LuCI state: installed, available, or disabled

The LuCI UI is disabled by default on first install. Low-memory routers can run out of memory when LuCI calls tailscale status --json through rpcd.

Manager self-update

CommandDescription
self-update [--yes]Reinstall this manager (script, libraries, init/cron scripts, and enabled LuCI files) to the latest version in one step. Leaves the Tailscale binary unchanged.

Other

CommandDescription
helpShow help message
--version, -vPrint the manager version and exit

Service Commands

Tailscale integrates with OpenWrt's procd init system:

sh
/etc/init.d/tailscale start     # Start the service
/etc/init.d/tailscale stop      # Stop the service
/etc/init.d/tailscale restart   # Restart the service
/etc/init.d/tailscale enable    # Enable at boot
/etc/init.d/tailscale disable   # Disable at boot

Tailscale Native Commands

After installation, the standard Tailscale CLI is available:

sh
tailscale status                               # Check connection status
tailscale up                                   # Connect to Tailscale network
tailscale down                                 # Disconnect
tailscale set --advertise-routes=192.168.1.0/24 # Advertise subnet
tailscale up --advertise-exit-node             # Advertise as exit node