{"id":17696291,"url":"https://github.com/erisa/ts-derp-docker","last_synced_at":"2025-05-13T04:38:03.722Z","repository":{"id":250640076,"uuid":"835032464","full_name":"Erisa/ts-derp-docker","owner":"Erisa","description":"Yet another take on a Tailscale DERP Docker image","archived":false,"fork":false,"pushed_at":"2025-03-28T10:53:46.000Z","size":19,"stargazers_count":10,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-20T22:32:35.689Z","etag":null,"topics":["derp","derper","docker","docker-compose","tailscale"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/Erisa.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,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"Erisa"}},"created_at":"2024-07-29T02:51:48.000Z","updated_at":"2025-04-15T15:13:01.000Z","dependencies_parsed_at":"2024-10-24T17:49:06.748Z","dependency_job_id":"a3ac8167-7dba-45df-9435-d1e8bd7a764b","html_url":"https://github.com/Erisa/ts-derp-docker","commit_stats":null,"previous_names":["erisa/ts-derp-docker"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fts-derp-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fts-derp-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fts-derp-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Erisa%2Fts-derp-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Erisa","download_url":"https://codeload.github.com/Erisa/ts-derp-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253877363,"owners_count":21977634,"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":["derp","derper","docker","docker-compose","tailscale"],"created_at":"2024-10-24T14:43:51.356Z","updated_at":"2025-05-13T04:38:03.689Z","avatar_url":"https://github.com/Erisa.png","language":"Dockerfile","readme":"# Erisa's Tailscale DERP Docker image\n\nThis is [yet](https://github.com/tijjjy/Tailscale-DERP-Docker) [another](https://github.com/fredliang44/derper-docker) take on a Tailscale DERP server in a Docker image.\n\nThe guiding principles that distinguish this from alternatives are:\n\n- Compatibility with all [containerboot](https://pkg.go.dev/tailscale.com/cmd/containerboot) environment variables.\n- Stable and predictable versioning, using the same version of Tailscale and DERP together to ensure stability. \n- Will not run Tailscale if not desired.\n- Full functioning of `/debug/` routes.\n- Ease of use. Just clone, set variables, and `docker compose up -d`.\n- Support for multiple architectures.\n\nThe image is available on `ghcr.io/erisa/ts-derper` with the `:latest` tag serving the latest stable version of Tailscale and some versioned tags being available for specific versions.\n\n## Setup\n\nIn short, and assuming you want to verify clients are part of your tailnet:\n\n- Setup DNS records on a subdomain to point to the public IPv4/IPv6 of the machine that's going to run the DERP server. \n- Clone the repository: `$ git clone https://github.com/Erisa/ts-derp-docker \u0026\u0026 cd ts-derp-docker`\n- Create your own copy of the `.env`: `$ cp example.env .env`\n- Edit `.env` with an [auth key](https://login.tailscale.com/admin/settings/keys), the domain and an optional hostname.\n\t- I recommend attaching a tag to your authkey, such as `tag:derpers`.\n- Run `docker compose up -d`\n- Add the DERP server to your tailnet, as [directed by the documentation](https://tailscale.com/kb/1118/custom-derp-servers#step-2-adding-derp-servers-to-your-tailnet).\n\nThe following ports are required by default:\n\n```\n80/tcp (HTTP)\n443/tcp (HTTPS)\n3478/udp (STUN)\n```\n\nPort 80 [normally cannot be changed](https://tailscale.com/kb/1118/custom-derp-servers#required-ports), but you are welcome to try and see.\n\nYou can change HTTPS and STUN to different ports in the `.env` configuration. You must then update [DERPnode.DERPPort](https://pkg.go.dev/tailscale.com/tailcfg#DERPNode.DERPPort) and [DERPNode.STUNPort](https://pkg.go.dev/tailscale.com/tailcfg#DERPNode.STUNPort) accordingly.\n\nIf you need custom certificates, set `TS_DERP_CERTMODE` to `manual` and place the files in `./certs` as `derp.example.com.crt` and `derp.example.com.key`.\n\n## Credits\n\n- [tijjjy](https://github.com/tijjjy) for [Tailscale-DERP-Docker](https://github.com/tijjjy/Tailscale-DERP-Docker)\n","funding_links":["https://github.com/sponsors/Erisa"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferisa%2Fts-derp-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ferisa%2Fts-derp-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ferisa%2Fts-derp-docker/lists"}