Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 17 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,7 @@ ScaleTail provides ready-to-run [Docker Compose](https://docs.docker.com/compose
| ☁️ **NextCloud** | A suite of client-server software for creating and using file hosting services. | [Details](services/nextcloud) |
| 🤖 **Open WebUI** | A self-hosted AI platform with a ChatGPT-style interface for local and cloud-based models. | [Details](services/open-webui) |
| 🔗 **Pingvin Share** | **PROJECT ARCHIVED** A self-hosted file sharing platform. | [Details](services/pingvin-share) |
| 📅 **Radicale** | A lightweight CalDAV and CardDAV server for self-hosted calendar, to-do, and contact sync. | [Details](services/radicale) |
| 🔄 **Resilio Sync** | A fast, reliable, and simple file sync and share solution. | [Details](services/resilio-sync) |
| 🗂️ **Stirling-PDF** | A web application for managing and editing PDF files. | [Details](services/stirlingpdf) |
| 📄 **BentoPDF** | A lightweight, self-hosted web app for viewing and managing PDF documents. | [Details](services/bentopdf) |
Expand All @@ -172,6 +173,7 @@ ScaleTail provides ready-to-run [Docker Compose](https://docs.docker.com/compose
| 🖥️ **Changedetection.io** | A tool for monitoring website changes. | [Details](services/changedetection) |
| 🛠️ **Coder** | Self-hosted cloud dev environments with browser IDEs, Terraform-managed workspaces. | [Details](services/coder) |
| 🔧 **Cyberchef** | A web app for encryption, encoding, compression, and data analysis. | [Details](services/cyberchef) |
| 🐳 **Dockge** | A fancy, easy-to-use and reactive self-hosted Docker Compose stack manager. | [Details](services/dockge) |
| 🐳 **Dockhand** | A modern, lightweight Docker management UI for containers and Compose stacks. | [Details](services/dockhand) |
| 🖥️ **Dozzle** | A real-time log viewer for Docker containers. | [Details](services/dozzle) |
| 🔁 **FossFLOW** | A self-hosted tool to make beautiful isometric infrastructure diagrams. | [Details](services/fossflow) |
Expand Down Expand Up @@ -282,22 +284,29 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod
<sub><b>michaelhodges</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/lcs-crr">
<img src="https://avatars.githubusercontent.com/u/98816628?v=4" width="100;" alt="lcs-crr"/>
<br />
<sub><b>lcs-crr</b></sub>
</a>
</td>
<td align="center">
<a href="https://github.com/adamsthws">
<img src="https://avatars.githubusercontent.com/u/52178922?v=4" width="100;" alt="adamsthws"/>
<br />
<sub><b>adamsthws</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/theryukverse">
<img src="https://avatars.githubusercontent.com/u/22323518?v=4" width="100;" alt="theryukverse"/>
<br />
<sub><b>theryukverse</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/KhaaL">
<img src="https://avatars.githubusercontent.com/u/692524?v=4" width="100;" alt="KhaaL"/>
Expand Down Expand Up @@ -333,15 +342,15 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod
<sub><b>mikkotor</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/NI-R0">
<img src="https://avatars.githubusercontent.com/u/98448863?v=4" width="100;" alt="NI-R0"/>
<br />
<sub><b>NI-R0</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/RychidM">
<img src="https://avatars.githubusercontent.com/u/106770998?v=4" width="100;" alt="RychidM"/>
Expand Down Expand Up @@ -377,15 +386,15 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod
<sub><b>pjv</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/wedge22">
<img src="https://avatars.githubusercontent.com/u/34723349?v=4" width="100;" alt="wedge22"/>
<br />
<sub><b>wedge22</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/Jacob-JA-Shanks">
<img src="https://avatars.githubusercontent.com/u/44290899?v=4" width="100;" alt="Jacob-JA-Shanks"/>
Expand Down Expand Up @@ -421,15 +430,15 @@ A huge thank you to all our contributors! ScaleTail wouldn’t be what it is tod
<sub><b>cdkooistra</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/Aurorainic">
<img src="https://avatars.githubusercontent.com/u/88829187?v=4" width="100;" alt="Aurorainic"/>
<br />
<sub><b>Aurorainic</b></sub>
</a>
</td>
</tr>
<tr>
<td align="center">
<a href="https://github.com/ironicbadger">
<img src="https://avatars.githubusercontent.com/u/2773080?v=4" width="100;" alt="ironicbadger"/>
Expand Down
18 changes: 18 additions & 0 deletions services/dockge/.env
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
#version=1.1
#URL=https://github.com/tailscale-dev/ScaleTail
#COMPOSE_PROJECT_NAME= # Optional: only use when running multiple deployments on the same infrastructure.

# Service Configuration
SERVICE=dockge
IMAGE_URL=louislam/dockge:1
STACKS_DIR=... # Directory on host to store stack files. Must be bind mounted to the same path in compose.yaml.

# Network Configuration
SERVICEPORT= # Port to expose to local network. Uncomment the "ports:" section in compose.yaml to enable.
DNS_SERVER=9.9.9.9 # Preferred DNS server for Tailscale. Uncomment the "dns:" section in compose.yaml to enable.

# Tailscale Configuration
TS_AUTHKEY=... # Auth key from https://tailscale.com/admin/authkeys. See: https://tailscale.com/kb/1085/auth-keys#generate-an-auth-key for instructions.

# Optional Service variables
# PUID=1000
24 changes: 24 additions & 0 deletions services/dockge/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Dockge with Tailscale Sidecar Configuration

This Docker Compose configuration sets up [Dockge](https://github.com/louislam/dockge) with Tailscale as a sidecar container to keep the app reachable over your Tailnet.

## Dockge

[Dockge](https://github.com/louislam/dockge) is fancy, easy-to-use and reactive self-hosted docker compose.yaml stack-oriented manager.

## Key Features

- Manage your compose.yaml files
- Create/Edit/Start/Stop/Restart/Delete
- Update Docker Images
- Interactive Editor for compose.yaml
- Interactive Web Terminal
- Convert docker run ... commands into compose.yaml
- File based structure - Dockge won't kidnap your compose files, they are stored on your drive as usual. You can interact with them using normal docker compose commands
- Reactive - Everything is just responsive. Progress (Pull/Up/Down) and terminal output are in real-time
- Easy-to-use & fancy UI - If you love Uptime Kuma's UI/UX, you will love this one too

## Configuration Overview

In this setup, the `tailscale-dockge` service runs Tailscale, which manages secure networking for Dockge. The `dockge` service utilizes the Tailscale network stack via Docker's `network_mode: service:` configuration. This keeps the app Tailnet-only unless you intentionally expose ports.

82 changes: 82 additions & 0 deletions services/dockge/compose.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,82 @@
name: dockge
services:
application:
container_name: app-dockge
depends_on:
tailscale:
condition: service_healthy
required: true
environment:
DOCKGE_STACKS_DIR: '...'
image: louislam/dockge:1
network_mode: service:tailscale
restart: always
volumes:
- type: bind
source: /var/run/docker.sock
target: /var/run/docker.sock
bind: {}
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/dockge/data
target: /app/data
bind: {}
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/dockge/...
target: '...'
bind: {}
tailscale:
cap_add:
- net_admin
configs:
- source: ts-serve
target: /config/serve.json
container_name: tailscale-dockge
devices:
- source: /dev/net/tun
target: /dev/net/tun
permissions: rwm
environment:
TS_AUTH_ONCE: "true"
TS_AUTHKEY: '# Auth key from https://tailscale.com/admin/authkeys. See: https://tailscale.com/kb/1085/auth-keys#generate-an-auth-key for instructions.'
TS_ENABLE_HEALTH_CHECK: "true"
TS_LOCAL_ADDR_PORT: 127.0.0.1:41234
TS_SERVE_CONFIG: /config/serve.json
TS_STATE_DIR: /var/lib/tailscale
TS_USERSPACE: "false"
hostname: dockge
healthcheck:
test:
- CMD
- wget
- --spider
- -q
- http://127.0.0.1:41234/healthz
timeout: 10s
interval: 1m0s
retries: 3
start_period: 10s
image: tailscale/tailscale:latest
networks:
default: null
restart: always
volumes:
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/dockge/config
target: /config
bind: {}
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/dockge/ts/state
target: /var/lib/tailscale
bind: {}
networks:
default:
name: dockge_default
configs:
ts-serve:
name: dockge_ts-serve
content: |
{"TCP":{"443":{"HTTPS":true}},
"Web":{"$${TS_CERT_DOMAIN}:443":
{"Handlers":{"/":
{"Proxy":"http://127.0.0.1:5001"}}}},
"AllowFunnel":{"$${TS_CERT_DOMAIN}:443":false}}
17 changes: 17 additions & 0 deletions services/radicale/.env
Original file line number Diff line number Diff line change
@@ -0,0 +1,17 @@
#version=1.1
#URL=https://github.com/tailscale-dev/ScaleTail
#COMPOSE_PROJECT_NAME= # Optional: only use when running multiple deployments on the same infrastructure.

# Service Configuration
SERVICE=radicale # Service name (e.g., adguard). Used as hostname in Tailscale and for container naming (app-${SERVICE}).
IMAGE_URL=tomsquest/docker-radicale # Docker image URL from container registry (e.g., adguard/adguard-home).

# Network Configuration
SERVICEPORT= # Port to expose to local network. Uncomment the "ports:" section in compose.yaml to enable.
DNS_SERVER=9.9.9.9 # Preferred DNS server for Tailscale. Uncomment the "dns:" section in compose.yaml to enable.

# Tailscale Configuration
TS_AUTHKEY=... # Auth key from https://tailscale.com/admin/authkeys. See: https://tailscale.com/kb/1085/auth-keys#generate-an-auth-key for instructions.

# Optional Service variables
# PUID=1000
33 changes: 33 additions & 0 deletions services/radicale/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Radicale with Tailscale Sidecar Configuration

This Docker Compose configuration sets up [Radicale](https://radicale.org/) with Tailscale as a sidecar container to keep the app reachable over your Tailnet.

## Radicale

[Radicale](https://radicale.org/) is a small but powerful CalDAV (calendars, to-do lists) and CardDAV (contacts) server. It is lightweight, easy to configure, and requires minimal resources, making it a great self-hosted alternative to cloud-based calendar and contact sync services.

## Key Features

- CalDAV and CardDAV support for syncing calendars, to-do lists, and contacts
- Works with any compliant client (Thunderbird, GNOME Calendar, DAVx5, Apple Calendar, etc.)
- Lightweight with minimal resource usage
- Simple file-based storage
- Web interface for managing collections
- Built-in access control and authentication

## Configuration Overview

In this setup, the `tailscale-radicale` service runs Tailscale, which manages secure networking for Radicale. The `radicale` service utilizes the Tailscale network stack via Docker's `network_mode: service:` configuration. This keeps the app Tailnet-only unless you intentionally expose ports.

The container runs with hardened security settings: read-only filesystem, no new privileges, dropped capabilities, and resource limits (256M memory, 50 pids).

## Prerequisites

- This image uses [tomsquest/docker-radicale](https://github.com/tomsquest/docker-radicale). Refer to their documentation for advanced configuration options.
- To configure users and authentication, mount a custom config file or refer to the [Radicale documentation](https://radicale.org/v3.html#configuration).

## Files to check

Please check the following contents for validity as some variables need to be defined upfront.

- `.env` // Main variable: `TS_AUTHKEY`
98 changes: 98 additions & 0 deletions services/radicale/compose.yaml
Original file line number Diff line number Diff line change
@@ -0,0 +1,98 @@
name: radicale
services:
application:
cap_add:
- SETUID
- SETGID
- CHOWN
- KILL
cap_drop:
- ALL
container_name: app-radicale
depends_on:
tailscale:
condition: service_healthy
required: true
deploy:
resources:
limits:
memory: "268435456"
pids: 50
healthcheck:
test:
- CMD
- curl
- -f
- http://127.0.0.1:5232
timeout: 10s
interval: 30s
retries: 3
start_period: 10s
image: tomsquest/docker-radicale
init: true
network_mode: service:tailscale
read_only: true
restart: always
security_opt:
- no-new-privileges:true
volumes:
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/radicale/radicale-data/data
target: /data
bind: {}
tailscale:
cap_add:
- net_admin
configs:
- source: ts-serve
target: /config/serve.json
container_name: tailscale-radicale
devices:
- source: /dev/net/tun
target: /dev/net/tun
permissions: rwm
environment:
TS_AUTH_ONCE: "true"
TS_AUTHKEY: '# Auth key from https://tailscale.com/admin/authkeys. See: https://tailscale.com/kb/1085/auth-keys#generate-an-auth-key for instructions.'
TS_ENABLE_HEALTH_CHECK: "true"
TS_LOCAL_ADDR_PORT: 127.0.0.1:41234
TS_SERVE_CONFIG: /config/serve.json
TS_STATE_DIR: /var/lib/tailscale
TS_USERSPACE: "false"
hostname: radicale
healthcheck:
test:
- CMD
- wget
- --spider
- -q
- http://127.0.0.1:41234/healthz
timeout: 10s
interval: 1m0s
retries: 3
start_period: 10s
image: tailscale/tailscale:latest
networks:
default: null
restart: always
volumes:
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/radicale/config
target: /config
bind: {}
- type: bind
source: /home/lcs_crr/Projects/ScaleTail/services/radicale/ts/state
target: /var/lib/tailscale
bind: {}
networks:
default:
name: radicale_default
configs:
ts-serve:
name: radicale_ts-serve
content: |
{"TCP":{"443":{"HTTPS":true}},
"Web":{"$${TS_CERT_DOMAIN}:443":
{"Handlers":{"/":
{"Proxy":"http://127.0.0.1:5232"}}}},
"AllowFunnel":{"$${TS_CERT_DOMAIN}:443":false}}