Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/2tiny2scale/scaletail

Tailscale Sidecar Configurations for Docker
https://github.com/2tiny2scale/scaletail

docker docker-compose dockercompose sidecar sidecar-container sidecar-proxy tailscale tailscale-exit-node tailscale-network tailscale-proxy

Last synced: about 6 hours ago
JSON representation

Tailscale Sidecar Configurations for Docker

Awesome Lists containing this project

README

        

# ScaleTail - Tailscale Docker Sidecar Configuration Examples

This repository provides examples of using [Tailscale](https://tailscale.com/) 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](templates/service-template/) or simply open an [issue](https://github.com/2Tiny2Scale/tailscale-docker-sidecar-configs/issues).

## Table of Contents
- [Available Configurations](#available-configurations)
- [Networking and Security](#networking-and-security)
- [Media and Entertainment](#media-and-entertainment)
- [Productivity and Collaboration](#productivity-and-collaboration)
- [Development Tools](#development-tools)
- [Monitoring and Analytics](#monitoring-and-analytics)
- [Tailscale Information](#tailscale-information)
- [Tailscale Funnel vs. Tailscale Serve](#tailscale-funnel-vs-tailscale-serve)
- [Tailscale Funnel](#tailscale-funnel)
- [Tailscale Serve](#tailscale-serve)
- [Tailscale Documentatuion](#tailscale-documentation)
- [License](#license)

## Available Configurations

### Networking and Security

| 🌐 Service | πŸ“ Description | πŸ”— Link |
| -------------------------- | ------------------------------------------------------------------------ | --------------------------------------- |
| πŸ›‘οΈ **AdGuard Home** | Network-wide software for blocking ads and tracking. | [Details](services/adguardhome) |
| 🧩 **Pi-hole** | A network-level ad blocker that acts as a DNS sinkhole. | [Details](services/pihole) |
| πŸ”’ **Technitium DNS** | An open-source DNS server that can be used for self-hosted DNS services. | [Details](services/technitium) |
| 🌐 **Traefik** | A modern reverse proxy and load balancer for microservices. | [Details](services/traefik) |
| πŸš€ **Tailscale Exit Node** | Configure a device to act as an exit node for your Tailscale network. | [Details](services/tailscale-exit-node) |
| 🌐 **DDNS Updater** | A self-hosted solution to keep DNS A/AAAA records updated automatically. | [Details](services/ddns-updater) |

### Media and Entertainment

| πŸŽ₯ Service | πŸ“ Description | πŸ”— Link |
| --------------------- | ------------------------------------------------------------------------------------------ | ---------------------------------- |
| 🎬 **Plex** | A media server that organizes video, music, and photos from personal media libraries. | [Details](services/plex) |
| πŸ“Ί **Jellyfin** | An open-source media system that puts you in control of managing and streaming your media. | [Details](services/jellyfin) |
| 🎞️ **Radarr** | A movie collection manager for Usenet and BitTorrent users. | [Details](services/radarr) |
| πŸ“‘ **Sonarr** | A PVR for Usenet and BitTorrent users to manage TV series. | [Details](services/sonarr) |
| πŸŽ₯ **Bazarr** | A companion tool to Radarr and Sonarr for managing subtitles. | [Details](services/bazarr) |
| πŸ“Š **Tautulli** | A monitoring and tracking tool for Plex Media Server. | [Details](services/tautulli) |
| πŸ“₯ **qBittorrent** | An open-source BitTorrent client. | [Details](services/qbittorrent) |
| πŸ”— **Slink** | A fast, self-hosted alternative to ShareDrop for secure local file sharing. | [Details](services/slink) |
| 🎧 **Audiobookshelf** | A self-hosted audiobook and podcast server with multi-user support and playback syncing. | [Details](services/audiobookshelf) |

### Productivity and Collaboration

| πŸ’Ό Service | πŸ“ Description | πŸ”— Link |
| -------------------- | ------------------------------------------------------------------------------- | ---------------------------------- |
| ☁️ **NextCloud** | A suite of client-server software for creating and using file hosting services. | [Details](services/nextcloud) |
| πŸ“ **Excalidraw** | A virtual collaborative whiteboard tool. | [Details](services/excalidraw) |
| πŸ”— **Pingvin Share** | A self-hosted file sharing platform. | [Details](services/pingvin-share/) |
| πŸ—‚οΈ **Stirling-PDF** | A web application for managing and editing PDF files. | [Details](services/stirlingpdf) |
| 🧠 **LanguageTool** | An open-source proofreading software for multiple languages. | [Details](services/languagetool) |
| πŸ”„ **Resilio Sync** | A fast, reliable, and simple file sync and share solution. | [Details](services/resilio-sync) |
| πŸ—ƒοΈ **Vaultwarden** | An unofficial Bitwarden server implementation written in Rust. | [Details](services/vaultwarden) |
| 🌿 **Isley** | A self-hosted cannabis grow journal for tracking plants and managing grow data. | [Details](services/isley) |
| βœ‚οΈ **ClipCascade** | A self-hosted clipboard manager for syncing and organizing clipboard history. | [Details](services/clipcascade) |
| πŸ”– **Linkding** | A self-hosted bookmark manager to save and organize links. | [Details](services/linkding) |

### Development Tools

| πŸ› οΈ Service | πŸ“ Description | πŸ”— Link |
| ------------------------- | ---------------------------------------------------------------------------------------- | ----------------------------------- |
| πŸ”§ **Cyberchef** | A web app for encryption, encoding, compression, and data analysis. | [Details](services/cyberchef) |
| πŸ” **searXNG** | A free internet metasearch engine which aggregates results from various search services. | [Details](services/searxng) |
| πŸ–₯️ **Node-RED** | A flow-based development tool for visual programming. | [Details](services/nodered) |
| πŸ–₯️ **IT-Tools** | A collection of handy online tools for developers and sysadmins. | [Details](services/it-tools) |
| πŸ–₯️ **Dozzle** | A real-time log viewer for Docker containers. | [Details](services/dozzle) |
| πŸ–₯️ **Portainer** | A lightweight management UI which allows you to easily manage your Docker environments. | [Details](services/portainer) |
| πŸ–₯️ **Gokapi** | A lightweight self-hosted file sharing platform. | [Details](services/gokapi) |
| πŸ–₯️ **Homarr** | A sleek dashboard for all your Homelab services. | [Details](services/homarr) |
| πŸ–₯️ **Changedetection.io** | A tool for monitoring website changes. | [Details](services/changedetection) |

### Monitoring and Analytics

| πŸ“ˆ Service | πŸ“ Description | πŸ”— Link |
| ------------------------ | ---------------------------------------------------------------------------------------- | ------------------------------------- |
| πŸ“Š **Uptime Kuma** | A self-hosted monitoring tool like "Uptime Robot". | [Details](services/uptime-kuma) |
| πŸ“‰ **Beszel** | A lightweight server monitoring hub with historical data, Docker stats, and alerts. | [Details](services/beszel) |
| πŸš€ **Speedtest Tracker** | A self-hosted tool to monitor and log internet speed tests with detailed visualizations. | [Details](services/speedtest-tracker) |

## 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](https://tailscale.com/kb/1223/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](funnel-serve/funnel-example.json).

![Tailscale Funnel](images/tailscale-funnel.png)

### Tailscale Serve

[Tailscale Serve](https://tailscale.com/kb/1312/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](funnel-serve/serve-example.json).

![Tailscale Serve](images/tailscale-serve.png)

## Tailscale Documentation

- [Tailscale.com - Knowledge Base](https://tailscale.com/kb)
- [Tailscale.com - Funnel](https://tailscale.com/kb/1223/funnel)
- [Tailscale.com - Serve](https://tailscale.com/kb/1242/tailscale-serve)
- [Tailscale.com - Docker Tailscale Guide](https://tailscale.com/blog/docker-tailscale-guide)

## License

[MIT](https://choosealicense.com/licenses/mit/)