Skip to content

Tailscale Sidecar Configurations for Docker

License

Notifications You must be signed in to change notification settings

tailscale-dev/ScaleTail

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

ScaleTail - Tailscale Docker Sidecar Configuration Examples

This repository provides examples of using Tailscale in a sidecar configuration within Docker, specifically for integrating Tailscale with various services. By leveraging Tailscale's secure networking capabilities, these examples demonstrate how to seamlessly route traffic through Tailscale while maintaining service functionality and security.

The provided configurations showcase how to set up Tailscale alongside Docker services, with a focus on ensuring connectivity, security, and ease of deployment. The examples include configurations for Tailscale authentication, state management, and service routing.

If you would like to add your own config, you can use the service-template or simply open an issue.

Table of Contents

Helpful videos and docs

Available Configurations

๐ŸŒ Networking and Security

๐ŸŒ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿ›ก๏ธ AdGuard Home Network-wide software for blocking ads and tracking. Details
๐Ÿ”„ AdGuardHome Sync A tool for syncing configuration across multiple AdGuard Home instances. Details
๐ŸŒ Caddy Caddy is an extensible server platform that uses TLS by default. Details
๐ŸŒ DDNS Updater A self-hosted solution to keep DNS A/AAAA records updated automatically. Details
๐Ÿ” Nessus A powerful vulnerability scanner with a free Essentials model for home use. Details
๐Ÿ—ƒ๏ธ Netbox NetBox is the leading solution for modeling and documenting modern networks. Details
๐Ÿงฉ Pi-hole A network-level ad blocker that acts as a DNS sinkhole. Details
๐Ÿ†” Pocket ID A self-hosted decentralized identity (OIDC) solution for secure authentication. Details
๐Ÿ”’ Technitium DNS An open-source DNS server that can be used for self-hosted DNS services. Details
๐ŸŒ Traefik A modern reverse proxy and load balancer for microservices. Details
๐Ÿš€ Tailscale Exit Node Configure a device to act as an exit node for your Tailscale network. Details

๐ŸŽฅ Media and Entertainment

๐ŸŽฅ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐ŸŽง Audiobookshelf A self-hosted audiobook and podcast server with multi-user support and playback syncing. Details
๐ŸŽฅ Bazarr A companion tool to Radarr and Sonarr for managing subtitles. Details
๐Ÿ“š BookLore A self-hosted application for managing and reading books. Details
๐ŸŽฎ Hytale A self-hosted Hytale game server. Details
๐Ÿ–ผ๏ธ Immich A self-hosted Google Photos alternative with face recognition and mobile sync. Details
๐Ÿ“บ Jellyfin An open-source media system that puts you in control of managing and streaming your media. Details
๐Ÿ“บ Jellyseerr A request management and media discovery tool for Jellyfin and Plex users. Details
๐ŸŽถ Navidrome Your Personal Streaming Service self-hosted. Details
๐ŸŽถ Swing Music A fast, beautiful, self-hosted music streaming server for your local audio library. Details
๐ŸŽฌ Overseerr A request management and media discovery tool for Plex and Jellyfin users. Details
๐ŸŽต Picard MusicBrainz Picard is a cross-platform music tagger for organizing and tagging music files. Details
๐ŸŽฌ Plex A media server that organizes video, music, and photos from personal media libraries. Details
๐Ÿ“ฅ qBittorrent An open-source BitTorrent client. Details
๐Ÿ“ก Prowlarr An indexer manager and proxy for applications like Radarr, Sonarr, and Lidarr. Details
๐ŸŽž๏ธ Radarr A movie collection manager for Usenet and BitTorrent users. Details
๐Ÿ“ก Sonarr A PVR for Usenet and BitTorrent users to manage TV series. Details
๐Ÿ”— Slink A fast, self-hosted alternative to ShareDrop for secure local file sharing. Details
๐Ÿ“Š Tautulli A monitoring and tracking tool for Plex Media Server. Details
โš™๏ธ Configarr Manage and sync configuration for Radarr, Sonarr, and related services. Details
๐Ÿ–ผ๏ธ Posterizarr Automatically generates and updates posters/artwork for media libraries. Details
โ™ป๏ธ Recyclarr Tools for managing, migrating, and maintaining indexers and quality profiles. Details

๐Ÿ’ผ Productivity and Collaboration

๐Ÿ’ผ Service ๐Ÿ“ Description ๐Ÿ”— Link
โœ‚๏ธ ClipCascade A self-hosted clipboard manager for syncing and organizing clipboard history. Details
๐Ÿ—‚๏ธ Copyparty A self-hosted file server with accelerated resumable uploads. Details
โœ… Donetick A self-hosted task and checklist manager for productivity. Details
๐Ÿ“š Docmost A self-hosted, real-time collaborative wiki with rich editing, diagrams, permissions, and full-text search. Details
โœ… DumbDo A self-hosted, minimalistic task manager for simple to-do lists. Details
โœ… Eigenfocus A self-hosted task and project management tool for productivity. Details
๐Ÿ“ Excalidraw A virtual collaborative whiteboard tool. Details
๐Ÿ“ Flatnotes A simple, self-hosted note-taking app using Markdown files. Details
๐Ÿ‘จ๐Ÿผโ€๐Ÿ’ป Forgejo A community-driven, self-hosted Git service. Details
โœ๏ธ Ghost A modern, open-source publishing platform for blogs and newsletters. Details
๐Ÿง‘โ€๐Ÿง‘โ€๐Ÿง’โ€๐Ÿง’ Gramps Web A web-based genealogy platform for collaborative family tree browsing, editing, AI-powered chat, media tagging, mapping, charts, search, and reporting. Details
๐Ÿ”– Haptic Haptic is a new local-first & privacy-focused, open-source home for your markdown notes. Details
๐ŸŒฟ Isley A self-hosted cannabis grow journal for tracking plants and managing grow data. Details
๐Ÿ—’๏ธ Karakeep A self-hosted, collaborative note-taking app โ€” a private alternative to Google Keep. Details
๐Ÿ—‚๏ธ Kaneo A modern, self-hosted project management platform focused on simplicity. Details
๐Ÿง  LanguageTool An open-source proofreading software for multiple languages. Details
๐Ÿ”– Linkding A self-hosted bookmark manager to save and organize links. Details
๐Ÿ“ฅ Mattermost A self-hosted collaborative workflow and communication tool. Details
๐Ÿ“ Nanote A lightweight, self-hosted note-taking app with Markdown support. Details
โ˜๏ธ NextCloud A suite of client-server software for creating and using file hosting services. Details
๐Ÿ”— Pingvin Share PROJECT ARCHIVED A self-hosted file sharing platform. Details
๐Ÿ”„ Resilio Sync A fast, reliable, and simple file sync and share solution. Details
๐Ÿ—‚๏ธ Stirling-PDF A web application for managing and editing PDF files. Details
๐Ÿ“„ BentoPDF A lightweight, self-hosted web app for viewing and managing PDF documents. Details
๐Ÿ“‹ Formbricks A self-hosted, open-source platform for collecting user feedback, surveys, and NPS. Details
๐Ÿฆ Subtrackr A self-hosted web app to track subscriptions, renewal dates, costs, and payment methods. Details
๐Ÿ—ƒ๏ธ Vaultwarden An unofficial Bitwarden server implementation written in Rust. Details
๐Ÿ’ธ Wallos An open-source, self-hostable web app to track and manage your recurring subscriptions and expenses, with multi-currency support, customizable categories, and statistics. Details

๐Ÿ“Š Dashboards and Visualization

๐Ÿ“Š Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿงญ Glance A concise, customizable dashboard for self-hosted services and personal metrics. Details
๐Ÿ  Homepage A modern, highly customizable homepage for organizing links and monitoring services. Details

๐Ÿ› ๏ธ Development Tools

๐Ÿ› ๏ธ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿ–ฅ๏ธ Changedetection.io A tool for monitoring website changes. Details
๐Ÿ› ๏ธ Coder Self-hosted cloud dev environments with browser IDEs, Terraform-managed workspaces. Details
๐Ÿ”ง Cyberchef A web app for encryption, encoding, compression, and data analysis. Details
๐Ÿ–ฅ๏ธ Dozzle A real-time log viewer for Docker containers. Details
๐Ÿ–ฅ๏ธ GitSave A self-hosted service to back up your GitHub repositories via a simple REST API and scheduled runs. Details
๐Ÿ” FossFLOW A self-hosted tool to make beautiful isometric infrastructure diagrams. Details
๐Ÿ–ฅ๏ธ Gokapi A lightweight self-hosted file sharing platform. Details
๐Ÿ–ฅ๏ธ Homarr A sleek dashboard for all your Homelab services. Details
๐Ÿ–ฅ๏ธ IT-Tools A collection of handy online tools for developers and sysadmins. Details
๐Ÿ–ฅ๏ธ Node-RED A flow-based development tool for visual programming. Details
๐Ÿ–ฅ๏ธ Portainer A lightweight management UI which allows you to easily manage your Docker environments. Details
๐Ÿ” searXNG A free internet metasearch engine which aggregates results from various search services. Details

๐Ÿ“ˆ Monitoring and Analytics

๐Ÿ“ˆ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿ“‰ Beszel A lightweight server monitoring hub with historical data, Docker stats, and alerts. Details
๐Ÿ”Ž Portracker A simple, self-hosted port monitoring and tracking tool for auditing open ports. Details
๐Ÿš€ Speedtest Tracker A self-hosted tool to monitor and log internet speed tests with detailed visualizations. Details
๐Ÿ“Š Uptime Kuma A self-hosted monitoring tool like "Uptime Robot". Details

๐Ÿ  Smart Home

๐Ÿ  Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿก Home Assistant An open-source home automation platform for controlling smart devices. Details

๐Ÿ“ฑ Utilities

๐Ÿ“ฑ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿ” ConvertX A fast, full-featured self-hosted conversion API for images, docs, videos, and more. Details
๐Ÿ”” Gotify A simple server for sending and receiving messages in real-time. Details
๐Ÿ“ฃ ntfy A simple HTTP-based pub/sub notification service for sending push notifications. Details
๐Ÿš— LubeLogger Self-hosted vehicle maintenance tracker with private access. Details
๐Ÿ“ฑ Mini-QR A minimal, self-hosted QR code generator with a mobile-friendly UI. Details
๐Ÿ” Hemmelig A self-hosted, zero-knowledge encrypted secret sharing platform with expiring secrets. Details

๐Ÿฝ๏ธ Food & Wellness

๐Ÿฅ˜ Service ๐Ÿ“ Description ๐Ÿ”— Link
๐Ÿฅ˜ Mealie A self-hosted recipe manager and meal planner with features like shopping lists, scaling, and importing. Details
๐Ÿฅ˜ Tandoor Recipes A self-hosted recipe manager that also serves as a meal planner that has features such as nutrient tracking, shopping lists, importing and AI. Details

Tailscale Information

Tailscale Funnel vs. Tailscale Serve

Tailscale Funnel securely exposes services to the public internet. Tailscale Serve is for sharing content within a private Tailscale network (Tailnet). You'll need to decide how you want to expose the service, the configurations in this repository exposes the local Tailnet.

Tailscale Funnel

Tailscale Funnel is a feature that lets you route traffic from the wider internet to a local service running on a machine in your Tailscale network (known as a Tailnet). You can think of this as publicly sharing a local service, like a web app, for anyone to accessโ€”even if they donโ€™t have Tailscale themselves.

An example configuration for Tailscale Funnel for your service is available here.

Tailscale Funnel

Tailscale Serve

Tailscale Serve is a feature that lets you route traffic from other devices on your Tailscale network (known as a Tailnet) to a local service running on your device. You can think of this as sharing the service, such as a website, with the rest of your Tailnet.

An example configuration for Tailscale Serve for your service is available here.

Tailscale Serve

Tailscale Documentation

Contributing

See CONTRIBUTING.md for guidance on adding services with the template, documenting gotchas, and keeping Tailscale-sidecar setups consistent.

Star History

Star History Chart

License

MIT