-
Notifications
You must be signed in to change notification settings - Fork 113
Added dockge and radicale #266
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
lcs-crr
wants to merge
27
commits into
tailscale-dev:main
Choose a base branch
from
lcs-crr:main
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from 9 commits
Commits
Show all changes
27 commits
Select commit
Hold shift + click to select a range
8340b1a
Added dockge and radicale
lcs-crr b81dbff
re-added paperless
lcs-crr c11984d
Updated readme
lcs-crr 98a47bb
Merge branch 'main' into main
crypt0rr 16f0fba
docs(contributors): update README contributors
github-actions[bot] 9212428
docs(contributors): update README contributors
github-actions[bot] c8264bc
docs(contributors): update README contributors
github-actions[bot] 6e52692
Merge branch 'main' into main
lcs-crr 6fcf750
docs(contributors): update README contributors
github-actions[bot] f46cf4e
Merge branch 'main' into main
crypt0rr 87eb4bc
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] adfc5b0
Restored template format
lcs-crr 9b561af
Merge branch 'main' into main
crypt0rr 2341c3d
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] 166d217
refactor(dockge): update .env and README for clarity; adjust compose.…
crypt0rr aebb048
docs(dockge): add comments for SERVICE and IMAGE_URL in .env for clarity
crypt0rr 8627e77
docs(README): add Dockge service to the list of available configurations
crypt0rr c127e8c
fix(radicale): set SERVICEPORT to 5232 for local network exposure
crypt0rr 5fd41e5
Added documentation on how to get started and creating users
lcs-crr 4032385
Merge branch 'main' of github.com:lcs-crr/ScaleTail
lcs-crr 40920d7
Apply suggestions from code review
lcs-crr 228ae8a
Minor tweaks to README
lcs-crr 611d665
Merge branch 'main' into main
lcs-crr dd1ea81
md lint
lcs-crr 8cc49ae
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] e395858
Merge branch 'main' into main
lcs-crr 109fa47
docs(contributor): contrib-readme-action has updated readme
github-actions[bot] File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Some comments aren't visible on the classic Files Changed page.
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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. | ||
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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}} |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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` |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| 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}} |
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.