selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
tsbridge logo

Self-host tsbridge

v0.15.1

Tailscale reverse proxy for multiple services

BetaOpen SourceMIT
Updated2 days ago
LanguageGo
Setup difficultyModerate
Stars
317
Port
443 (HTTPS (TLS mode auto))
Requires
Tailscale
Docker
ghcr.io/jtdowney/tsbridge
Install with Docker

What is tsbridge?

tsbridge is a lightweight reverse proxy manager that uses Tailscale's tsnet library to expose multiple backend services on a Tailnet. It eliminates the need to run a separate tsnet sidecar for each service by managing multiple services from a single process. Configuration is done via a TOML file or automatically through Docker container labels, similar to Traefik. It supports OAuth authentication with Tailscale, Headscale compatibility, Prometheus metrics, trusted identity headers via Whois, Tailscale Funnel for public exposure, and streaming/SSE with configurable timeouts. The project targets homelabs and development environments and is not hardened for production workloads. It can be installed via pre-built binaries, Go install, or Docker images from ghcr.io.

tsbridge alternatives

All self-hosted alternatives to Tsnsrv →

Should you self-host tsbridge?

tsbridge scores 48/100 on selfhost.directory (how scoring works) and ranks #19 of 31 in Networking. It has 317 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v0.15.1, came out on 21 August 2026. New versions land roughly every 6 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Go.

Its closest alternative on selfhost.directory is headscale (82/100, 45 190 stars). It scores higher overall, so compare the two before you pick. See tsbridge vs headscale side by side.

Features

  • Docker label discovery
  • Ephemeral Nodes
  • Header manipulation
  • Headscale supportTLS must be disabled until Headscale issue #2137 is implemented
  • HTTPS backend support
  • Multi-service reverse proxy
  • Per-service configuration overrides
  • Prometheus Metrics
  • Streaming/SSE support
  • Tag ownership security model
  • TOML Configuration
  • Unix socket backends
  • Whois identity headers

tsbridge README

tsbridge

GitHub release (latest SemVer) GitHub Workflow Status Go Report Card License

tsbridge logo

tsbridge acts as a tsnet-powered reverse proxy, letting you expose multiple backend services on your Tailnet from a single process. It's designed for homelabs and development environments where you want the magic of Tailscale without the hassle of running a separate sidecar for every service.

How to install tsbridge

Install tsbridge with Docker

Environment variables
TS_OAUTH_CLIENT_ID, TS_OAUTH_CLIENT_SECRET

docker run -v /path/to/config:/config
-e TS_OAUTH_CLIENT_ID=...
-e TS_OAUTH_CLIENT_SECRET=...
ghcr.io/jtdowney/tsbridge:latest -config /config/tsbridge.toml

Static config with volume mount

tsbridge releases & version history

More in Homelab

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…