Templates for Dropshell
  • Python 63%
  • Shell 25.1%
  • HTML 4.8%
  • JavaScript 4.6%
  • CSS 2.3%
  • Other 0.2%
Find a file
j 3e43dd665a
All checks were successful
Test and Publish / test (push) Successful in 3m9s
Test and Publish / publish-modelcache (push) Successful in 4s
Test and Publish / publish-wg-mesh-scripts (push) Successful in 5s
Add backupfolders template
Backs up a list of host folders through dropshell's restic path. No
container and nothing running — the service is a folder list that gives
ds backup something to point at, for host data no other service owns.

Folders go in service.env as /abs/path or label=/abs/path, with optional
restic exclude patterns. Derived labels come from the whole path rather than
the basename, so they cannot collide and a snapshot says where its contents
came from. A folder that has gone missing fails the backup rather than being
skipped, since the agent would otherwise mount an empty directory over it and
store nothing where the data used to be.

Restore never writes over the original: it writes <folder>.restored and
leaves the comparison to a human. Restoring in place would delete anything
added since the snapshot, plus everything BACKUP_EXCLUDES deliberately kept
out of it — for live host folders that is rarely what anyone wants, and the
worst case here is wasted disk instead of lost data.

Adds listbackups and restorefolder for recovering a single folder from any
snapshot. Both read credentials from CONFIG_PATH/restic.env, as ds run passes
no environment of its own.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-29 21:54:28 +13:00
.gitea/workflows Pin CI to linux/amd64 instead of ubuntu-latest 2026-08-30 10:29:36 +12:00
authentik Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
backupfolders Add backupfolders template 2026-09-29 21:54:28 +13:00
caddy Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
caddy-static install-pre: tolerate registry blips, and move slow work pre-swap 2026-08-23 10:36:48 +12:00
docker-registry docker-registry: back up htpasswd only, not the blob store 2026-08-23 22:07:30 +12:00
ds-backup-server install-pre: tolerate registry blips, and move slow work pre-swap 2026-08-23 10:36:48 +12:00
forge-runner-docker Correct the build-cache retry comment in forge-runner-docker 2026-09-13 15:49:24 +12:00
forge-runner-lxc4native-gpu forge-runner-gpu: avoid SIGPIPE killing GPU detection under pipefail 2026-07-05 12:06:28 +12:00
forge-runner-native templates: stop pre-removing containers, fix unsafe installs 2026-08-23 15:11:04 +12:00
forgejo-server install-pre: tolerate registry blips, and move slow work pre-swap 2026-08-23 10:36:48 +12:00
gitea-server Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
go2rtc Add go2rtc template; remove apt-cacher-ng entry and APT proxy 2026-08-30 13:11:36 +12:00
hwspecs Add INFO_VERSION to cache entries and expose it in health check 2026-08-30 11:28:20 +12:00
immich Replace static compose files with on-demand rendering to prevent rsync 2026-09-13 22:14:53 +12:00
knowledgebase Add recursive folder-tree resolution for Google Drive sync 2026-09-24 14:47:32 +12:00
linkblog Add search box placeholder hint for non-hover devices and visualViewpo 2026-09-26 23:13:20 +12:00
lxc-provision Update 33 files 2026-06-20 16:03:29 +12:00
nomad Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
nvidia-power-limit Add GPU power limit initialization with polling and systemd ordering 2026-09-20 18:10:36 +12:00
openobserve Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
openwrt-config openwrt-config: add DNSMASQ_NONEGCACHE to disable dnsmasq negative caching 2026-06-27 10:52:57 +12:00
rustdesk-server Add rustdesk-server template (hbbs + hbbr, key-enforced) 2026-09-05 18:15:48 +12:00
sbsviewer Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
scrutiny Use _q shell-quoting for docker run args in start.sh scripts 2026-08-23 17:27:05 +12:00
seafile Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
shlink refactor(shlink): switch backup to hot single-transaction mariadb-dump 2026-08-30 20:06:15 +12:00
simple-object-server templates: stop pre-removing containers, fix unsafe installs 2026-08-23 15:11:04 +12:00
squashdisplay Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
squashthumbnailmaker Add go2rtc template; remove apt-cacher-ng entry and APT proxy 2026-08-30 13:11:36 +12:00
sshfs Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
tinyproxy Use _q shell-quoting for docker run args in start.sh scripts 2026-08-23 17:27:05 +12:00
turn-server Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
vlmcsd Use _q shell-quoting for docker run args in start.sh scripts 2026-08-23 17:27:05 +12:00
watchtower Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
wikijs Converge containers on install instead of stop/remove/start 2026-08-23 11:59:34 +12:00
.gitignore Add .gitignore and untrack Python bytecode caches 2026-06-28 23:08:08 +12:00
bump-version.sh Add 7 and update 2 files 2025-08-24 20:50:58 +12:00
detect-changes.sh Add 7 and update 2 files 2025-08-24 20:50:58 +12:00
README.md Add a Docker GC sidecar to forge-runner-docker 2026-09-13 15:40:58 +12:00
test.sh Update test.sh 2026-05-05 22:47:12 +12:00
test_template.sh Update ds command argument order across scripts and docs 2026-08-28 22:15:13 +12:00
versions.json Add rustdesk-server template (hbbs + hbbr, key-enforced) 2026-09-05 18:15:48 +12:00

Dropshell Templates

Templates for Dropshell. For template authoring docs, see TEMPLATES.md.


Infrastructure & Networking

Template Description Ports
caddy Reverse proxy with automatic HTTPS via Let's Encrypt 80, 443
cloudflare-config Manage Cloudflare DNS records (A, CNAME, TXT) via API None
openwrt-config Manage OpenWRT port forwards and DHCP static leases via UCI None
sshfs Read-only SSH file server accessible over Tailscale 22 (Tailscale)
watchtower Automatically updates running Docker containers to latest images None
ds-failover DNS failover via Cloudflare, health-checks hosts and updates A records None
ds-backup-server Centralised restic backup server with web dashboard — stores encrypted deduplicated snapshots for all dropshell services 8000, 8088
lxc-provision Provisions and manages LXC containers on Proxmox with Tailscale integration None
turn-server WebRTC TURN/STUN relay server (coturn) with automatic TLS via Let's Encrypt 3478, 5349, 49152-49252
go2rtc Camera restreamer — pulls RTSP/ONVIF feeds once and re-serves as RTSP/WebRTC/MSE/HLS. Keeps camera credentials on-site and gives a remote Frigate one stable address per stream 1984, 8554, 8555
rustdesk-server Self-hosted RustDesk ID + relay server (open-source remote desktop); key-enforced, unattended Android via adb pre-auth 21115-21119

Git & CI/CD

Template Description Ports
forgejo-server Forgejo git server with federation support and built-in CI/CD 3000, 2222
gitea-server Lightweight self-hosted Gitea git service 3000, 2222
forge-runner-native Native Forgejo Actions CI/CD runner (systemd-managed) None
forge-runner-docker Forgejo Actions CI/CD runner in Docker containers, with a Docker garbage collection sidecar None
docker-registry Private Docker image registry with htpasswd auth 5000

Logging & Monitoring

Template Description Ports
logserver Loki + Grafana centralized logging with web UI 3001, 3100
logclient Promtail log shipper for Docker and system logs to Loki None
graylog Enterprise log collection/analysis with OpenSearch and MongoDB 9000, 12201, 514
graylog-client Fluent Bit log shipper forwarding to Graylog None
scrutiny Hard drive S.M.A.R.T monitoring with failure prediction 8080

Storage & File Sharing

Template Description Ports
seafile Cloud storage with file sync, sharing, and collaboration 8080
simple-object-server Lightweight S3-compatible object storage server Configurable
immich Photo/video management with ML features and mobile apps 2283

Web Hosting

Template Description Ports
caddy-static Static file server with Caddy and automatic HTTPS 8080
wikijs Modern wiki with full-text search, markdown, and PostgreSQL 3080
shlink URL shortener with tracking, analytics, and API 8080
sbsviewer Stereoscopic (180°/SBS) 3D media gallery for AR glasses — depth-rendered UI, 2D/3D modes, 2D/3D download conversion, password-protected upload 8590

AI & Applications

Template Description Ports
nomad Offline-first knowledge/education/AI server (Kiwix, Ollama) 8080
knowledgebase Multi-user semantic knowledge base with connectors, sharing, and Authentik SSO 8560
model-cache AI model caching proxy — caches HuggingFace/URL downloads with versioning, pin-by-date, resume, background updates Configurable

Authentication

Template Description Ports
authentik Modern identity provider with OIDC/OAuth2/SAML/LDAP, admin UI, and user management 9000, 9443

Utilities

Template Description Ports
nvidia-power-limit GPU power throttling with boot persistence via systemd — prevents thermal throttling in multi-GPU setups None
vlmcsd KMS activation server for Windows/Office 1688
squashdisplay Configures Linux/Raspberry Pi as fullscreen kiosk display None
squashthumbnailmaker Generates video thumbnails using YOLOv8 pose detection None