Tailscale
Add tailnet devices as hosts and connect with Tailscale SSH.
- Add tailnet devices as hosts in a couple of clicks
- Connect with Tailscale SSH, with no credentials stored
- Works with Headscale
- A Tailscale card in Host Metrics
- A dashboard card with your tailnet devices and which are online
Tailscale connects Termix to your Tailscale tailnet. Add tailnet devices as hosts in a couple of clicks, and connect to them with Tailscale SSH so no passwords or keys are stored in Termix. It works with Headscale too.
Termix's server needs to be on the tailnet to reach those devices.
List your devices
- Make an API key in the Tailscale admin console, or with
headscale apikeys createfor Headscale. - Install the plugin from the Plugins tab.
- Open Settings, Tailscale and paste the API key. For Headscale, set Control server to Headscale and API base URL to your Headscale address, like
https://headscale.example. - Press Check to see how many devices it can reach.
Open the Tailscale panel from the sidebar to see your devices. Add host adds one as a host, and Copy Tailscale IP copies its 100.x address. In the host editor, Select Tailscale device fills in a device's address.
The key is stored encrypted. It is only used to list devices. Headscale does not report a device's OS, so that column stays empty for it.
On the dashboard
Add the Tailnet card in the dashboard's edit mode. It shows how many devices are online and lists them with the online ones first.
Tailscale SSH
If a host runs Tailscale SSH, Termix can connect with no credentials at all. Tailscale checks who you are and whether your tailnet's ACL allows it.
- On the host, turn on Tailscale SSH:
tailscale set --ssh. - In Termix, set the host's Authentication Method to Tailscale.
- Set the username to a Unix user your tailnet's SSH ACL lets you use. It doesn't have to be root.
If your ACL has check mode on, Termix asks you to sign in to Tailscale in the browser before it connects.
In Host Metrics
With Host Metrics on, hosts get a Tailscale card: whether Tailscale runs, its IPs, peers and status. Save the host's sudo password to allow changes from the card. Turning Tailscale on or off needs edit access to the host. With only connect access the card is read only.
Troubleshooting
- Tailscale SSH fails: Check Tailscale runs on the host, SSH is turned on with
tailscale set --ssh, and your ACL allows the connection from the Termix server's tailnet identity. - No devices: Check the API key, and the base URL for Headscale.
Who can see the device list is set by tailscale.devices.view. Only admins have it at first.