Skip to content

About

Self-hosted apps on a VPS: Docker Compose + Traefik with automatic HTTPS

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

12 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

docker-apps

docker-apps

Self-hosted services I run on my VPS: each app is a small Docker Compose project behind a single Traefik reverse proxy with automatic HTTPS.

check

Architecture

flowchart LR
    U[Internet] -->|80 / 443| T[Traefik<br/>HTTPS, Let's Encrypt]
    T -->|Host rule| A[app 1]
    T -->|Host rule| B[app 2]
    T -->|Host rule| C[app N]
    subgraph VPS [VPS · Docker]
        T
        A
        B
        C
    end
Loading
  • One shared external network proxy: Traefik finds apps by Docker labels, no ports are published except 80/443
  • Every app lives in its own folder with docker-compose.yml, .env.example and a README
  • Secrets stay in .env on the server, never in git
  • restart: unless-stopped, healthchecks and memory limits for every service
  • Databases and caches live in a per-app internal network and are never published
  • Stateful apps have a backup sidecar (docker-volume-backup): nightly archive of the volumes to WebDAV storage with 7-day retention; it stops only the containers of its own app (per-app label value)

Apps

App What it does Folder
Traefik Reverse proxy, Let's Encrypt certificates, HTTP → HTTPS apps/traefik
Monitoring Prometheus, Alertmanager → Telegram, Grafana, Loki + Promtail, node-exporter, cAdvisor apps/monitoring
Uptime Kuma Status page and uptime checks apps/uptime-kuma
Vaultwarden Password manager (Bitwarden-compatible) with nightly backups apps/vaultwarden
n8n Workflow automation apps/n8n
Paperless-ngx Document archive with OCR apps/paperless
WordPress WordPress + MySQL, tuned PHP, nightly backups apps/wordpress
Planka Kanban board with nightly backups apps/planka
Vikunja Task manager apps/vikunja
FreshRSS RSS reader + RSS-Bridge apps/freshrss
Mealie Recipes and meal planning apps/mealie
Memos Lightweight notes apps/memos
RustFS S3-compatible storage for Terraform state (native lock file) apps/rustfs
PostgreSQL Shared database for apps that need real SQL instead of SQLite (e.g. a leads bot), nightly backups apps/postgresql
Actual Budget Personal finance and budgeting, nightly backups apps/actual-budget
Wekan Kanban board on MongoDB, nightly backups apps/wekan
Matrix Synapse homeserver + PostgreSQL + Element web client, nightly backups apps/matrix
MTProto proxy Private Telegram proxy with Fake TLS (mtg) apps/mtproxy
GitLab Runner CI runner with the Docker executor, plus Helm values for Kubernetes apps/gitlab-runner

Add a new app

cp -r _template apps/<name>
cd apps/<name>
# rename "myapp" in docker-compose.yml, describe the app in README.md
cp .env.example .env   # fill in real values on the server
docker compose up -d

Checks

Every push runs GitHub Actions:

  • docker compose config for every compose file
  • promtool, amtool and loki -verify-config for the monitoring stack
  • gitleaks scan, so a password or token never lands in the repository

About

Self-hosted apps on a VPS: Docker Compose + Traefik with automatic HTTPS

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages