ScaleTail

Ready-to-run Docker Compose stacks for 120+ self-hosted apps, each with a Tailscale sidecar and automatic HTTPS

Automatically checked · GitHub checked 2026-11-12

Overview

ScaleTail

GitHub stars License Docker Tailscale

ScaleTail is a collection of ready-to-run Docker Compose stacks that connect self-hosted applications to your Tailnet. Each stack runs a Tailscale sidecar container, so the application joins your Tailnet as its own device. Most stacks publish the application at an HTTPS address such as https://vaultwarden.<tailnet>.ts.net, reachable from your Tailnet only.

Table of contents

Featured by Tailscale

In this video from the Tailscale YouTube channel, Alex deploys a ScaleTail service in under 10 minutes.

Watch "We got self-hosted apps for days with ScaleTail"

Quick Start

You need:

  • A Linux host with Docker Engine, Docker Compose 2.23.1 or later, and Git. Check the Compose version with docker compose version.
  • MagicDNS and HTTPS certificates enabled for your Tailnet, on the DNS page of the admin console. Without them, the https:// address of a stack does not work. With HTTPS enabled, device names appear in public certificate transparency logs.
  1. Create an auth key on the Keys page of the admin console.

    • Leave Ephemeral off. Tailscale removes an ephemeral device 30 to 60 minutes after it goes offline, for example when you stop the stack.
    • Turn on Pre-approved if your Tailnet uses device approval.
    • Turn on Reusable to use the key for more than one stack.
  2. Get the stacks and choose a service.

    git clone https://github.com/tailscale-dev/ScaleTail.git
    cd ScaleTail/services/<service>
    

    Replace <service> with the directory from the Details link in Available configurations, for example uptime-kuma.

  3. Read the service README. "Before you start" lists what the service needs beyond these steps, such as secrets to generate. Until you set them, Compose stops with an error such as required variable DB_PASSWORD is missing a value.

  4. Edit .env. Open the hidden file .env, for example with nano .env. Paste your auth key after TS_AUTHKEY= and set the values that the service README asks for.

  5. Start the stack.

    docker compose up -d
    docker compose ps
    

    The application starts after the tailscale container reports healthy. If a container is not running, read the logs with docker compose logs.

  6. Open the service. From a device in your Tailnet, open the address from "At a glance" in the service README, usually https://<SERVICE>.<tailnet>.ts.net.

    • <SERVICE> is the value of SERVICE in .env.
    • <tailnet>.ts.net is your Tailnet DNS name, for example tail1234.ts.net.
    • The first request can take up to a minute, because Tailscale requests the certificate at that moment.

    Then follow "First run" in the service README. Some stacks have no web interface, and their service README says how to reach them.

  7. Keep the device connected. Its node key expires after 180 days by default. To prevent that, disable key expiry for the device on the Machines page.

Every stack starts from the same standard setup, which explains the containers, the Tailnet address, the data folders, and the settings in .env.

Available configurations

Networking and security

ServiceDescriptionLink
AdGuard HomeDNS server that blocks ads and trackers on every device that uses it.Details
AdGuard Home SyncTool that copies the configuration of one AdGuard Home instance to replicas.Details
CaddyWeb server and reverse proxy with automatic HTTPS.Details
DDNS UpdaterUpdater that keeps DNS records pointed at your current public IP address.Details
FlareSolverrProxy that solves Cloudflare and DDoS-GUARD challenges.Details
NessusVulnerability scanner from Tenable, with the limited free Nessus Essentials license.Details
NetBoxNetwork documentation tool for IP addresses, racks, devices, connections, and circuits.Details
Pi-holeDNS sinkhole that blocks ads and trackers for every device that uses it.Details
Pocket IDOpenID Connect provider that signs users in to your services with passkeys.Details
RustDesk ServerYour own ID and relay server for RustDesk clients, so they skip the public servers.Details
Tailscale App Connector NodeApp connector that sends Tailnet traffic for chosen domains through this host.Details
Tailscale Exit NodeExit node that routes the internet traffic of other Tailnet devices through this host.Details
Tailscale Subnet Router NodeSubnet router that gives your Tailnet access to a local network.Details
Technitium DNSAuthoritative and recursive DNS server with ad blocking and your own zones.Details
TraefikReverse proxy and load balancer that routes requests to Docker containers by label.Details
VaultwardenUnofficial password manager server for the Bitwarden apps and extensions.Details

Media and entertainment

ServiceDescriptionLink
ArtistTrackarrTracker for new albums, EPs, singles, and compilations from Spotify.Details
AudiobookshelfServer for audiobooks and podcasts, with playback progress synced across devices.Details
AudioMuse-AITool that analyzes your music library and builds playlists for your media server.Details
BazarrSubtitle manager for movies and series in Radarr and Sonarr.Details
BookLoreBook manager and browser reader, with Kobo and KOReader sync. In maintenance mode.Details
ConfigarrTool that applies YAML settings and TRaSH Guides profiles to Radarr and Sonarr, then exits.Details
FreshRSSRSS and Atom feed reader that uses SQLite, with no separate database server.Details
FusionLightweight feed reader for RSS, Atom, and JSON feeds, with a Fever API.Details
HytaleHytale game server in a community image, for players on your Tailnet.Details
ImageMaidCleaner that removes unused poster and background images from the Plex metadata folder.Details
ImmichPhoto and video library that backs up mobile media, with search and sharing.Details
JellyfinMedia server that organizes and streams your movies, series, and music.Details
KavitaDigital library for comics, manga, and books, with progress synced across devices.Details
MeTubeWeb UI for yt-dlp that downloads videos and audio from YouTube and other sites.Details
MinecraftMinecraft Java Edition server that players reach over your Tailnet.Details
MinifluxMinimalist feed reader for RSS, Atom, and JSON feeds, with a PostgreSQL database.Details
NavidromeMusic server that streams your collection to its web player and Subsonic-compatible apps.Details
PicardMusicBrainz tag editor that writes tags and cover art, used in your browser.Details
PlexMedia server that streams your movies, series, and music to Plex apps; needs a Plex account.Details
PosterizarrPoster, background, and title card generator for Plex, Jellyfin, and Emby libraries.Details
ProwlarrIndexer manager for Usenet and torrent trackers, used by apps such as Radarr and Sonarr.Details
qBittorrentBitTorrent client with a web interface.Details
RadarrMovie manager that searches Usenet and BitTorrent and sorts files into your library.Details
RecyclarrTool that applies TRaSH Guides quality profiles from a YAML file to Radarr and Sonarr on a schedule.Details
SeerrRequest manager for Plex, Jellyfin, and Emby that sends approved requests to Radarr and Sonarr.Details
SlinkImage hosting platform that shares uploads through links.Details
SonarrSeries manager that searches Usenet and BitTorrent for new episodes.Details
StorytellerPlatform for reading ebooks with synced audiobook narration.Details
Swing MusicMusic player and streaming server for your local audio files.Details
TautulliMonitoring tool for Plex Media Server, with viewing history, statistics, and notifications.Details

Productivity and collaboration

ServiceDescriptionLink
Actual BudgetPersonal finance app for budgeting.Details
AFFiNEWorkspace for documents, whiteboards, and databases.Details
AnchorNote-taking app that works offline and syncs notes when you are back online.Details
BentoPDFPDF toolkit that works in your browser, without uploading files.Details
ClipCascadeServer that syncs your clipboard across devices, with end-to-end encryption.Details
CopypartyFile server with resumable uploads, browser access, and WebDAV.Details
CozyPersonal cloud (now Twake Workplace) for files, photos, notes, and contacts.Details
DocmostTeam wiki with real-time collaborative editing.Details
DonetickTask and chore manager for households and small groups.Details
DumbDoTo-do list app that keeps its lists in one file, with no database.Details
EigenfocusProject and task manager with boards, time tracking, and focus tools.Details
EspoCRMCustomer relationship manager for contacts, companies, and sales opportunities.Details
ExcalidrawVirtual whiteboard for sketching diagrams in a hand-drawn style.Details
File BrowserArchived. Web file manager for one folder on your server, with no further security fixes.Details
flatnotesNote-taking app that stores notes as plain Markdown files, with no database.Details
FormbricksSurvey and feedback platform for websites, apps, and links.Details
GhostPublishing platform for blogs and newsletters.Details
GokapiFile sharing server with links that expire after a number of downloads or days.Details
Gramps WebGenealogy web app for browsing and editing family trees together.Details
HapticMarkdown note editor that keeps notes in the browser, not on the server.Details
Invoice NinjaInvoicing app for quotes, invoices, expenses, and payments.Details
IsleyCannabis grow journal for plants, watering, feeding, harvests, and sensors.Details
Joplin ServerSync server for the Joplin note-taking apps, for personal non-commercial use.Details
KaneoOpen-source project tracker with boards and tasks, an alternative to Trello and Linear.Details
KarakeepBookmark manager that archives links, notes, and images, with full-text search and AI tagging.Details
LanguageToolGrammar and spelling checker server for browser extensions, with no web interface.Details
linkdingBookmark manager to save, tag, and search links.Details
Mail ArchiverArchives incoming mail and makes it searchable from the browser.Details
MattermostTeam chat platform with channels, direct messages, and integrations.Details
MemosNote-taking app for short Markdown notes, shown on a timeline.Details
NanoteNote-taking app that stores notes as Markdown files in folders.Details
NextExplorerWeb file manager for one folder on your server.Details
Open NotebookAlternative to NotebookLM for chatting with your sources using AI.Details
Open WebUIChat interface for AI models, through Ollama or OpenAI-compatible APIs.Details
OpenClawPersonal AI assistant that connects agents to your chat apps.Details
OpenCloudFile sync and sharing platform with desktop and mobile clients.Details
Paperless-ngxDocument management system that turns scans and files into a searchable archive.Details
Pingvin ShareArchived. File sharing platform with links that can expire.Details
RadicaleCalDAV and CardDAV server that syncs calendars, to-do lists, and contacts.Details
Resilio SyncPeer-to-peer tool that syncs folders between your devices, without a central server.Details
SeafileFile sync and sharing platform that stores files in libraries.Details
Stirling-PDFPDF toolbox that runs on the server. The free plan covers five users.Details
SubTrackrSubscription tracker that shows monthly and yearly costs and when each one renews.Details
SureFork of the archived Maybe finance app, for tracking accounts, investments, and net worth.Details
SyncthingPeer-to-peer tool that keeps folders in sync between your devices.Details
VikunjaTo-do and project app with lists, boards, and Gantt charts.Details
WallabagRead-it-later app that saves web pages as articles.Details
WallosSubscription tracker with payment reminders and budgets.Details
XWikiWiki for documentation and knowledge management.Details

Dashboards and visualization

ServiceDescriptionLink
DashyDashboard with status checks, widgets, and an editor in the web interface.Details
GlanceDashboard that puts feeds, such as RSS, weather, and markets, on one page.Details
HomarrDashboard with user accounts that shows live data from the apps you connect.Details
HomepageDashboard that you set up in YAML files, with bookmarks and live data from apps and Docker.Details
HomerStatic start page for your services, set up in one YAML file.Details
NewWallpaperWhoDisWallpaper server that rotates your collection on browsers, tablets, TVs, and dashboards.Details

Development tools

ServiceDescriptionLink
ArcaneWeb UI to manage Docker containers, images, networks, volumes, and Compose projects.Details
CoderPlatform for development environments and AI coding agents, from Terraform.Details
CyberChefWeb app for encoding, decoding, encrypting, compressing, and analyzing data.Details
DockgeWeb interface to manage Docker Compose stacks.Details
DockhandDocker manager for local and remote hosts, free for home use.Details
DozzleReal-time log viewer for Docker containers.Details
ForgejoCommunity-governed fork of Gitea.Details
FossFLOWTool for drawing isometric infrastructure diagrams.Details
GiteaGit service with repositories, pull requests, issues, packages, and CI.Details
GitSaveBackup tool for your Git repositories, run on a schedule.Details
IT-ToolsOnline tools for developers and IT staff, such as converters and generators.Details
MailpitEmail testing tool that captures outgoing mail over SMTP for viewing and debugging.Details
Node-REDLow-code, flow-based tool for event-driven applications.Details
OllamaRuntime for large language models, with an OpenAI-compatible API and no login.Details
PortainerWeb interface to manage Docker containers, images, volumes, and networks.Details
SearXNGMetasearch engine that combines results from many search services without tracking.Details
Semaphore UIWeb interface to run Ansible playbooks, Terraform, and scripts, with schedules.Details

Monitoring and analytics

ServiceDescriptionLink
Beszel AgentAgent that sends system and Docker stats to a Beszel hub.Details
Beszel HubServer monitor with history, Docker stats, and alerts.Details
changedetection.ioMonitor that watches web pages and notifies you when their content changes.Details
GatusStatus page and scheduled health checks for websites and services.Details
GrafanaDashboards and alerts for metrics, logs, and traces from many data sources.Details
LogchefLog analytics interface for logs that already live in ClickHouse or VictoriaLogs.Details
PortrackerPort tracker that discovers the services on your systems and maps the ports they use.Details
Speedtest TrackerTool that runs scheduled internet speed tests and charts the results over time.Details
UmamiWeb analytics that uses no cookies and collects no personal data.Details
Uptime KumaMonitor for websites and services that alerts you when they go down.Details

Smart home

ServiceDescriptionLink
FrigateNetwork video recorder with real-time AI object detection for IP cameras, using an optional GPU or accelerator.Details
Home AssistantHome automation platform for local control of smart devices.Details

Utilities

ServiceDescriptionLink
ConvertXWeb file converter for more than a thousand formats.Details
GotifyPush notification server that shows messages from your scripts in its web interface and Android app.Details
HemmeligArchived. Encrypted secret sharing by link, with secrets deleted after reading or on expiry.Details
HomeboxHome inventory for items, with location, quantity, warranty, and purchase details.Details
KasmPlatform that streams desktops and apps to your browser, each in a container.Details
LibreTranslateMachine translation service with a web interface and an API, running on your own server.Details
LubeLoggerTracker for vehicle maintenance and fuel use.Details
Mini QRWeb app to create, style, and scan QR codes.Details
ntfyNotification service that lets scripts and apps push messages to phones and browsers over HTTP.Details
TracktorTracker for vehicle fuel use, maintenance, insurance, and documents, with renewal dates.Details
TransmuteConverter and compressor for images, video, audio, and documents, with a web UI and API.Details

Food and wellness

ServiceDescriptionLink
Clean SlateCalorie tracker for food, recipes, and exercise.Details
KitchenOwlGrocery list and recipe manager for households, with meal planning and expenses.Details
MealieRecipe manager and meal planner with shopping lists and imports from web addresses.Details
openGymGym and body-weight tracker for routines and workouts.Details
Tandoor RecipesRecipe manager and meal planner with shopping lists.Details

Update a stack

Most stacks use the latest image tag. To get newer images, run this from the service directory:

docker compose pull
docker compose up -d

To get the latest version of the stacks, update your clone. Git does not overwrite files that you changed, such as .env, so set your changes aside first:

git stash
git pull
git stash pop

If git stash pop reports a conflict in .env, open the file, keep your values, delete the <<<<<<<, =======, and >>>>>>> lines, then run git reset and git stash drop.

Before you restart the stack, read the "Upgrading" section of the service README, if it has one.

Keep your changes out of the clone

This section is optional. The steps in Quick Start work as they are. Use one of these options when you run several stacks, or when git pull or switching branches runs into your .env or into data that the containers wrote as root.

Run the stack from a copy

Copy the service directory out of the clone, before the first start, and run the stack from the copy:

cp -R ScaleTail/services/<service> ~/stacks/<service>
cd ~/stacks/<service>

Your .env, the Tailscale state, and the application data now live outside the clone, so git pull in the clone never conflicts with them. A copy no longer follows the repository, so to pick up changes, update the clone and compare the files:

git -C ScaleTail pull
diff ScaleTail/services/<service>/compose.yaml ~/stacks/<service>/compose.yaml
diff ScaleTail/services/<service>/.env ~/stacks/<service>/.env

The .env comparison also lists the values you set yourself. Look for variables that are new upstream, such as a new required secret, and add them to your copy.

Read the "Upgrading" section of the service README before you apply a change.

Keep your changes in an override file

To stay in the clone, put your changes to compose.yaml in a file named compose.override.yaml (singular) next to it. Compose reads both files without extra options, and git pull never touches an untracked file. Entries in volumes and environment replace the entry with the same container path or variable name, so an override can also move data out of the clone:

services:
  tailscale:
    volumes:
      - /srv/scaletail/<service>/ts/state:/var/lib/tailscale
  application:
    volumes:
      - /srv/scaletail/<service>/data:/config

Use the container path from the volumes of the application in compose.yaml. Check the result with docker compose config. The override file does not cover .env, which is tracked, so keep using git stash for it, or run the stack from a copy.

Remove a stack

From the service directory, run docker compose down --volumes. To remove the stack completely, also remove the device on the Machines page and delete the service directory. It contains the Tailscale state in ./ts/state and the application data. The containers create some of these folders as root, so deleting them may need sudo.

Get help

  • Read the "Troubleshooting" section of the service README, and check the logs with docker compose logs.
  • Ask questions in the Tailscale Discord.
  • Report a problem with a stack in a GitHub issue.

Tailscale Serve and Funnel

Every stack has two containers that share one network: a Tailscale container and the application. Tailscale Serve and Tailscale Funnel are two ways to let other people reach the application through the Tailscale container.

Diagram with two paths into a ScaleTail stack. Path 1, Serve: a device in your Tailnet opens https://<service>.<tailnet>.ts.net, and Serve in the Tailscale container forwards the request to the application at 127.0.0.1:80. Path 2, Funnel: a visitor on the internet reaches the same Serve through a Funnel relay server run by Tailscale, but only when AllowFunnel is true.

Serve: your Tailnet only

  1. A device in your Tailnet opens https://<service>.<tailnet>.ts.net. The traffic travels through Tailscale, encrypted by WireGuard.
  2. The Tailscale container receives it on port 443 and ends the HTTPS connection with a certificate for that name.
  3. Serve forwards the request to the application. Both containers share one network namespace, so the application is at 127.0.0.1 and its internal port, for example 127.0.0.1:80.

Serve is on in every stack that sets TS_SERVE_CONFIG. Only devices in your Tailnet can use it, and your Tailnet policy can restrict them further.

Funnel: the public internet

Funnel is off by default. Stacks that use Serve keep it off with "AllowFunnel":{"$${TS_CERT_DOMAIN}:443":false} in compose.yaml. Umami has an opt-in public mode; see its README.

When you turn Funnel on, a second path opens next to the first:

  1. A visitor without Tailscale opens the same address. The name resolves to a Funnel relay server run by Tailscale, not to your machine.
  2. The relay opens a TCP proxy to your Tailscale container. It passes the traffic on and cannot read it, because the HTTPS connection still ends in your container.
  3. From there, the request follows the same Serve route to the application.

The Serve route does not change. Funnel only adds a way in for visitors from outside your Tailnet.

Turn Funnel on

  1. Add funnel to nodeAttrs in your Tailnet policy file for the device, as described in Tailscale Funnel.
  2. In compose.yaml, change false to true in the AllowFunnel line.
  3. Recreate the stack with docker compose up -d --force-recreate.

Funnel is in beta and listens only on ports 443, 8443, and 10000. It requires MagicDNS and HTTPS certificates, as in the Quick Start. Anyone on the internet can then reach the application, so turn on its login first.

Documentation

In this repository:

From Tailscale:

Contributors

Thank you to everyone who has contributed to ScaleTail.

ScaleTail contributors

Made with contrib.rocks.

Contributing

To add or update a service, follow CONTRIBUTING.md and start from the service template.

Star history

Star History Chart

License

MIT