Skip to content

Configuration

All settings are stored in UCI format at /etc/config/tailscale.

Full Configuration Reference

ini
config tailscale 'settings'
    option enabled '1'              # Enable/disable the service
    option port '41641'             # Tailscale UDP port
    option storage_mode 'persistent' # persistent | ram
    option bin_dir '/opt/tailscale'  # Binary directory
    option state_file '/etc/config/tailscaled.state' # State file path
    option statedir '/etc/tailscale' # State directory
    option fw_mode 'nftables'       # Firewall mode: nftables | iptables
    option download_source 'small'  # Download source: official | small
    option net_mode 'auto'          # Networking mode: auto | tun | userspace
    option proxy_listen 'localhost' # Proxy listen: localhost | lan
    option auto_update '1'          # Auto-update: 0 | 1

Editing Configuration

Via UCI Commands

sh
uci set tailscale.settings.port=12345
uci commit tailscale
/etc/init.d/tailscale restart

Via LuCI

If the LuCI interface is installed, use Services → Tailscale → Configuration.

Options Reference

OptionValuesDefaultDescription
enabled0 / 11Enable or disable the Tailscale service
portinteger41641UDP port for Tailscale WireGuard traffic
storage_modepersistent / rampersistentWhere to store binaries
bin_dirpath/opt/tailscaleBinary installation directory
state_filepath/etc/config/tailscaled.stateTailscale state file
statedirpath/etc/tailscaleTailscale state directory
fw_modenftables / iptablesnftablesFirewall backend
download_sourceofficial / smallsmallBinary download source
net_modeauto / tun / userspaceautoNetwork mode
proxy_listenlocalhost / lanlocalhostProxy listen address (userspace only)
auto_update0 / 11Enable daily auto-update cron job