{"id":13998228,"url":"https://github.com/tailscale-dev/deck-tailscale","last_synced_at":"2025-07-23T06:31:04.061Z","repository":{"id":180805388,"uuid":"662814306","full_name":"tailscale-dev/deck-tailscale","owner":"tailscale-dev","description":"Tailscale install script for the Steam Deck","archived":false,"fork":false,"pushed_at":"2024-04-28T14:08:06.000Z","size":59,"stargazers_count":335,"open_issues_count":10,"forks_count":22,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-11-24T20:59:59.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tailscale-dev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2023-07-06T00:27:42.000Z","updated_at":"2024-11-24T19:17:58.000Z","dependencies_parsed_at":"2023-11-20T04:25:26.037Z","dependency_job_id":"e0f852d7-ebeb-466c-bcc5-8740f9112403","html_url":"https://github.com/tailscale-dev/deck-tailscale","commit_stats":null,"previous_names":["legowerewolf/deck-tailscale","tailscale-dev/deck-tailscale"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailscale-dev%2Fdeck-tailscale","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailscale-dev%2Fdeck-tailscale/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailscale-dev%2Fdeck-tailscale/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tailscale-dev%2Fdeck-tailscale/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tailscale-dev","download_url":"https://codeload.github.com/tailscale-dev/deck-tailscale/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227245138,"owners_count":17753239,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-09T19:01:29.387Z","updated_at":"2024-11-30T00:31:19.413Z","avatar_url":"https://github.com/tailscale-dev.png","language":"Shell","funding_links":[],"categories":["Shell"],"sub_categories":[],"readme":"# Tailscale on the Steam Deck\r\n\r\nThis process is derived from the [official guide](https://tailscale.com/blog/steam-deck), but has been\r\ntweaked to make the process smoother and produce an installation that comes up\r\nautomatically on boot (no need to enter desktop mode).\r\n\r\n## Installing Tailscale\r\n\r\n1. Clone this repo to your Deck.\r\n2. Run `sudo bash tailscale.sh` to install Tailscale (or update the existing\r\n   installation).\r\n3. Run `source /etc/profile.d/tailscale.sh` to put the binaries in your path\r\n4. Run `sudo tailscale up --qr --operator=deck --ssh` to have Tailscale generate\r\n   a login QR code. Scan the code with your phone and authenticate with\r\n   Tailscale to bring your Deck onto your network.\r\n\r\n## Updating Tailscale\r\n\r\nTailscale should be able to update itself now! Try running\r\n`sudo tailscale update`, and if that works, `sudo tailscale set --auto-update`.\r\nIf it doesn't, keep reading.\r\n\r\n\u003e ⚠️ This process will most likely fail if you are accessing the terminal over\r\n\u003e Tailscale SSH, as it seems to be locked in a chroot jail. You should start and\r\n\u003e connect through the standard SSH server instead, but remember to stop it when\r\n\u003e you're done.\r\n\u003e [Suggestions for how to fix this are welcomed.](https://github.com/legowerewolf/deck-tailscale/issues/2)\r\n\r\n1. Git fetch and pull to make sure you're up to date.\r\n2. Run `sudo bash tailscale.sh` again.\r\n\r\nThis process overwrites the existing binaries and service file, so it's not\r\nrecommended to tweak those files directly. The configuration file at\r\n`/etc/default/tailscaled` is left alone. The configuration file at\r\n`/etc/systemd/system/tailscaled.service.d/override.conf` is reset every time this script is run to ensure the path to the binary is correct, but the preexisting file will be backed up in that directory as `override.conf.bak`. If something goes wrong, copy those files somewhere else and re-run the install script to get back to a working state.\r\n\r\n## Common issues\r\n\r\n### Broken config file\r\n\r\nSymptom: `invalid value \"\" for flag -port: can't be the empty string`\r\n\r\nResolution: Delete `/etc/default/tailscaled` and re-run installer script.\r\n\r\n## How it works\r\n\r\nThe Tailscale binaries `tailscale` and `tailscaled` are installed in `/opt/tailscale/`. The Tailscale systemd unit file is installed at `/etc/systemd/system/tailscale.service`. The override file to reconfigure the services `Exec` commands is installed at `/etc/systemd/system/tailscaled.service.d/override.conf`. The defaults file for the variables `PORT` and `FLAGS` is installed at `/etc/default/tailscaled`\r\n\r\nThe service is then started and enabled via `systemctl`.\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftailscale-dev%2Fdeck-tailscale","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftailscale-dev%2Fdeck-tailscale","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftailscale-dev%2Fdeck-tailscale/lists"}