Skip to main content
Move this server to another network: status, re-bind, WiFi and watcher. Operations for carrying this server from one network to another. Before the move, stage the destination WiFi (stackkit network wifi add). After the move the server gets a new address from the destination DHCP; the network watcher (stackkit network watch enable, installed by stackkit apply) notices that the recorded site address is stale and re-binds the stack by itself.
Subcommands: stackkit network rebind, stackkit network status, stackkit network watch, stackkit network wifi

stackkit network rebind

Re-bind the stack to this server’s new network address. After the server moved to another network, re-issue the signed LAN resolver record for the new address and regenerate and apply the stack so listeners bind to it. Nothing happens when the server did not move. Owner identity, secrets, certificate authorities and data are not touched; the previous resolver record is kept under .stackkit/custody/backups. LAN clients and the router’s DNS must point at the new resolver address afterwards.
Examples

stackkit network status

Show whether this server moved to another network. Compare the address this server has now with the address recorded in the LAN resolver custody and in .stackkit/inventory.yaml. The verdict is “in-place” when they match, “moved” when a recorded address is stale, and “unknown” when there is nothing to compare. The command always exits 0.
Examples

stackkit network watch

Re-bind automatically after the server moved (systemd timer). Install a systemd timer that runs “stackkit network rebind --yes --auto” every minute and shortly after boot. It is silent while the network is unchanged, runs one rebind at a time and waits five minutes after a failed attempt. stackkit apply enables it on systemd hosts; set STACKKIT_NETWORK_WATCH=off or run “stackkit network watch disable” to opt out.
Subcommands: stackkit network watch disable, stackkit network watch enable, stackkit network watch status

stackkit network watch disable

Stop and remove the network watcher timer.

stackkit network watch enable

Install and start the network watcher timer.

stackkit network watch status

Show whether the network watcher timer is installed and running.

stackkit network wifi

Pre-stage the destination WiFi before moving the server. Stage WiFi networks in the host’s own network configuration so the server joins the destination WiFi by itself after the move. NetworkManager is used when it is running, otherwise netplan. The wired DHCP connection is not touched and passphrases are written only to the system network configuration (root only, mode 0600); they are never printed or stored by StackKits.
Subcommands: stackkit network wifi add, stackkit network wifi list, stackkit network wifi remove

stackkit network wifi add

Stage a WiFi network that is joined automatically when in range.
Examples

stackkit network wifi list

List the staged WiFi networks (never their passphrases).

stackkit network wifi remove

Remove a staged WiFi network.