mirror of
https://github.com/tailscale-dev/deck-tailscale.git
synced 2025-10-22 15:38:15 +00:00
41 lines
1.7 KiB
Markdown
41 lines
1.7 KiB
Markdown
# Tailscale on the Steam Deck
|
|
|
|
This process is derived from the [official guide][official-guide], but lightly
|
|
tweaked to make the process smoother and produce an installation that comes up
|
|
automatically on boot (no need to enter desktop mode) and survives system
|
|
updates.
|
|
|
|
## Installing Tailscale
|
|
|
|
⚠️ This process will probably fail if you are accessing the terminal over
|
|
Tailscale SSH, as it seems to be locked in a chroot jail. You should start and
|
|
connect through the standard SSH server instead. Suggestions for how to fix this
|
|
are welcomed.
|
|
|
|
1. Clone this repo to your Deck.
|
|
2. Copy the `tailscaled.service` file to `/etc/systemd/system/`.
|
|
3. Run `sudo bash tailscale.sh` to install Tailscale (or update the existing
|
|
installation).
|
|
4. Run `sudo tailscale up --qr --operator=deck --ssh` to have Tailscale generate
|
|
a login QR code. Scan the code with your phone and authenticate with
|
|
Tailscale to bring your Deck onto your network.
|
|
|
|
## How it works
|
|
|
|
It uses the same system extension method as the official guide, but we put the
|
|
`tailscaled.service` file directly in `/etc/systemd/system/` because it's
|
|
actually safe to put things there. Changes in `/etc/` are preserved in
|
|
`/var/lib/overlays/etc/upper/` via an overlayfs, meaning that they survive
|
|
updates.
|
|
|
|
[official-guide]: https://tailscale.com/blog/steam-deck/
|
|
|
|
## Future work (PRs welcome!)
|
|
|
|
- Figure out how to make this work over Tailscale SSH.
|
|
- Copy the `tailscaled.service` file to `/etc/systemd/system/` automatically.
|
|
- Automatically resolve the NetworkManager/systemd-resolved warning in
|
|
`tailscale status` (Is
|
|
[this solution](https://tailscale.com/kb/1188/linux-dns/#networkmanager--systemd-resolved)
|
|
safe to do on the Deck?)
|