Skip to content
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
27 commits
Select commit Hold shift + click to select a range
8340b1a
Added dockge and radicale
lcs-crr Apr 11, 2026
b81dbff
re-added paperless
lcs-crr Apr 11, 2026
c11984d
Updated readme
lcs-crr Apr 11, 2026
98a47bb
Merge branch 'main' into main
crypt0rr Apr 13, 2026
16f0fba
docs(contributors): update README contributors
github-actions[bot] Apr 13, 2026
9212428
docs(contributors): update README contributors
github-actions[bot] Apr 14, 2026
c8264bc
docs(contributors): update README contributors
github-actions[bot] Apr 15, 2026
6e52692
Merge branch 'main' into main
lcs-crr Apr 15, 2026
6fcf750
docs(contributors): update README contributors
github-actions[bot] Apr 15, 2026
f46cf4e
Merge branch 'main' into main
crypt0rr Apr 18, 2026
87eb4bc
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] Apr 18, 2026
adfc5b0
Restored template format
lcs-crr Apr 27, 2026
9b561af
Merge branch 'main' into main
crypt0rr Apr 29, 2026
2341c3d
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] Apr 29, 2026
166d217
refactor(dockge): update .env and README for clarity; adjust compose.…
crypt0rr Apr 29, 2026
aebb048
docs(dockge): add comments for SERVICE and IMAGE_URL in .env for clarity
crypt0rr Apr 29, 2026
8627e77
docs(README): add Dockge service to the list of available configurations
crypt0rr Apr 29, 2026
c127e8c
fix(radicale): set SERVICEPORT to 5232 for local network exposure
crypt0rr Apr 29, 2026
5fd41e5
Added documentation on how to get started and creating users
lcs-crr May 7, 2026
4032385
Merge branch 'main' of github.com:lcs-crr/ScaleTail
lcs-crr May 7, 2026
40920d7
Apply suggestions from code review
lcs-crr May 13, 2026
228ae8a
Minor tweaks to README
lcs-crr May 13, 2026
611d665
Merge branch 'main' into main
lcs-crr May 13, 2026
dd1ea81
md lint
lcs-crr May 13, 2026
8cc49ae
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] May 13, 2026
e395858
Merge branch 'main' into main
lcs-crr May 24, 2026
109fa47
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] May 24, 2026
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
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
Comment thread
crypt0rr marked this conversation as resolved.
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}}
28 changes: 0 additions & 28 deletions services/paperless/.env

This file was deleted.

13 changes: 0 additions & 13 deletions services/paperless/README.md

This file was deleted.

108 changes: 0 additions & 108 deletions services/paperless/compose.yml

This file was deleted.

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`
Loading