⚙️ Services — Core Homelab Megastack
Host: Homelab · Compose:
Homelab/Docker/services/compose.yaml
Stack name:services[!NOTE] Update Available: Updates for this stack are pending in:
renovate/docker-dependencies,renovate/major-docker-dependencies.
1. Overview
The largest compose file in the homelab. This is the main services megastack containing general-purpose applications: a homepage dashboard, document management, automation, databases, monitoring tools, developer tools, and various utilities. All services share common external Docker networks and are routed through Traefik or Cloudflare Tunnel.
2. Architecture & Services
| Service | Image | Port | Role |
|---|---|---|---|
code-server |
ghcr.io/linuxserver/code-server:4.145.2 |
8443 |
— |
dad_magicmirror |
karsten13/magicmirror:v2.38.0 |
— | — |
database |
mariadb:11.8.9 |
3306 |
— |
database_mysql |
mysql:5.7 |
3307 |
— |
epicgames-freegames |
charlocharlie/epicgames-freegames:c64d897b9ca8113ea4933ff18d86a3b0f726827a |
— | — |
ftp |
delfer/alpine-ftp-server:latest@sha256:60bb774d8408d9d4d5c74d05d1c086a34ce192c6c1a142ffac268cac0dbc6fac |
21, 21000-21010 |
— |
gatus |
twinproduction/gatus:v5.38.0 |
8081 |
— |
gatus_db |
11notes/postgres:17@sha256:6860d92d13eabd73703220ebc9ee401c12922d4eb7715e70adf3b2041768a486 |
— | — |
grafana |
grafana/grafana:13.3.0 |
— | — |
granna_magicmirror |
karsten13/magicmirror:v2.38.0 |
— | — |
guacd |
guacamole/guacd:latest@sha256:ed47289dc3b2ef66dad5282f3cdf77c889a40faca31de42aec7a1ec6e0c69965 |
4822 |
— |
hass_db |
11notes/postgres:17@sha256:6860d92d13eabd73703220ebc9ee401c12922d4eb7715e70adf3b2041768a486 |
5431 |
— |
homehub |
ghcr.io/surajverma/homehub:0.2.3.4 |
5372 |
— |
homepage |
ghcr.io/gethomepage/homepage:v2.7.0 |
3022 |
— |
influxdb_peanut |
influxdb:2.9.1 |
— | — |
it-tools |
ghcr.io/corentinth/it-tools:2024.10.22-7ca5933 |
8075 |
— |
meilisearch |
getmeili/meilisearch:v1.56.2 |
7700 |
— |
n8n |
n8nio/n8n:3.1.0 |
5678 |
— |
node-red |
nodered/node-red:4.1.17-20 |
1880 |
— |
omni-tools |
iib0011/omni-tools:0.7.0 |
38080 |
— |
open-webui |
ghcr.io/open-webui/open-webui:latest@sha256:59b912d4246103c7285de0e9a5f2f6586614c06b4c4e46edc51a8f29e7b099a5 |
— | — |
paperless-ng |
ghcr.io/paperless-ngx/paperless-ngx:3.4.2 |
8839 |
— |
peanut |
brandawg93/peanut:6.1.2 |
28080 |
— |
pgadmin |
dpage/pgadmin4:9.19.0 |
— | — |
postgres |
postgres:17 |
5432 |
— |
pulse |
rcourtman/pulse:6.7.0 |
7655 |
— |
recipes |
vabene1111/recipes:2.7.2 |
8181 |
— |
recipes_db |
11notes/postgres:17@sha256:6860d92d13eabd73703220ebc9ee401c12922d4eb7715e70adf3b2041768a486 |
— | — |
redis |
redis:6.2 |
6379 |
— |
remmina |
lscr.io/linuxserver/remmina:1.4.35dfsg-0ubuntu5.1-ls165 |
— | — |
scrob-db |
postgres:16-alpine |
— | — |
scrob |
bellamy/scrob:latest |
7330 |
— |
scrutiny |
ghcr.io/analogj/scrutiny:master-web@sha256:192656ce791dc3e5bda7f7bf81cd3cb9f77ab2cde42a9bd0d8cac442b7e8bee1 |
8180 |
SMART disk health monitoring |
simple-dash |
busybox:1.38.0 |
34566 |
Minimal HTTP static file server (homelab dash) |
speedtest_db |
11notes/postgres:17@sha256:6860d92d13eabd73703220ebc9ee401c12922d4eb7715e70adf3b2041768a486 |
— | PostgreSQL for Speedtest Tracker |
speedtest-tracker |
lscr.io/linuxserver/speedtest-tracker:1.15.1 |
8448, 8870 |
Scheduled internet speed tests |
stirling-pdf |
frooodle/s-pdf:3.3.0 |
8085 |
PDF manipulation tools |
termix |
ghcr.io/lukegus/termix:release-2.9.2 |
— | Web-based terminal / remote desktop (Guacamole-based) |
whatsupdocker |
getwud/wud:9.8.0 |
3000 |
— |
3. Networking
backend— —cloudflare-net— —database— —gatus-net— —internal— —servers— —termix-net— —traefik— —
4. Persistent Storage
| Container | Host Path / Volume | Description |
|---|---|---||
| code-server | /docker | — |
| code-server | /docker/services/code/config | — |
| dad_magicmirror | /docker/data/services/magicmirror/dad/config | — |
| dad_magicmirror | /docker/data/services/magicmirror/dad/images | — |
| dad_magicmirror | /docker/data/services/magicmirror/shared/css | — |
| dad_magicmirror | /docker/data/services/magicmirror/shared/modules | — |
| database | /docker/services/mariadb | — |
| database_mysql | /docker/services/mysql | — |
| epicgames-freegames | /docker/services/epicgames/config/ | — |
| ftp | /docker/services/paperless-ng/consume | — |
| gatus | /docker/data/services/gatus | — |
| gatus_db | /backup/database/services/gatus | — |
| gatus_db | gatus.postgres.etc | — |
| gatus_db | gatus.postgres.var | — |
| grafana | /docker/services/grafana | — |
| granna_magicmirror | /docker/data/services/magicmirror/granna/config | — |
| granna_magicmirror | /docker/data/services/magicmirror/granna/images | — |
| granna_magicmirror | /docker/data/services/magicmirror/shared/css | — |
| granna_magicmirror | /docker/data/services/magicmirror/shared/modules | — |
| hass_db | /backup/database/services/hass | — |
| hass_db | hass.postgres.etc | — |
| hass_db | hass.postgres.var | — |
| homehub | /docker/data/services/homehub/config.yml | — |
| homehub | /docker/data/services/homehub/data | — |
| homehub | /docker/data/services/homehub/media | — |
| homehub | /docker/data/services/homehub/pdfs | — |
| homehub | /docker/data/services/homehub/uploads | — |
| homepage | /Storage | — |
| homepage | /docker/services/homepage/homepage-conf | — |
| homepage | /docker/services/homepage/icons/ | — |
| homepage | /docker/services/homepage/images/ | — |
| homepage | /var/run/docker.sock | — |
| influxdb_peanut | /docker/services/penut/influxdb | — |
| meilisearch | /docker/services/meilisearch | — |
| n8n | /docker/services/n8n | — |
| node-red | /docker/services/nodered/data | — |
| open-webui | open-webui | — |
| paperless-ng | /docker/services/paperless-ng/consume | — |
| paperless-ng | /docker/services/paperless-ng/data | — |
| paperless-ng | /docker/services/paperless-ng/export | — |
| paperless-ng | /docker/services/paperless-ng/media | — |
| peanut | /docker/services/penut/config | — |
| pgadmin | /docker/gui/obsidian/files | — |
| pgadmin | pgadmin-data | — |
| postgres | /docker/services/database/postgres | — |
| pulse | /docker/data/services/pulse | — |
| recipes | /docker/data/services/recipes/mediafiles | — |
| recipes | /docker/data/services/recipes/staticfiles | — |
| recipes_db | /backup/database/services/recipes | — |
| recipes_db | recipes.postgres.etc | — |
| recipes_db | recipes.postgres.var | — |
| remmina | /docker/data/services/remmina/config | — |
| scrob-db | /docker/services/scrob/db_data | — |
| scrob | /docker/services/scrob/scrob_data | — |
| scrutiny | /docker/services/scrutiny/config | Disk health history |
| simple-dash | /docker/data/services/dash | — |
| speedtest_db | /backup/database/services/speedtest | — |
| speedtest_db | speedtest.postgres.etc | — |
| speedtest_db | speedtest.postgres.var | — |
| speedtest-tracker | /docker/services/speedtest-tracker/config | Speed test history |
| speedtest-tracker | /docker/services/speedtest-tracker/ssl-keys | — |
| stirling-pdf | /docker/stirling/extraConfigs | — |
| stirling-pdf | /docker/stirling/trainingData | — |
| termix | /docker/data/services/termix | — |
| whatsupdocker | /var/run/docker.sock | — |
5. Environment Variables
| Variable | Service | Description |
|---|---|---|
PGID |
code-server |
— |
PROXY_DOMAIN |
code-server |
— |
PUID |
code-server |
— |
TZ |
code-server |
— |
MYSQL_DATABASE |
database |
— |
MYSQL_PASSWORD |
database |
— |
MYSQL_ROOT_PASSWORD |
database |
— |
MYSQL_USER |
database |
— |
MYSQL_ROOT_PASSWORD |
database_mysql |
— |
TZ |
epicgames-freegames |
— |
ADDRESS |
ftp |
— |
USERS |
ftp |
— |
POSTGRES_BACKUP_RETENTION |
gatus_db |
— |
POSTGRES_BACKUP_SCHEDULE |
gatus_db |
— |
POSTGRES_PASSWORD |
gatus_db |
— |
TZ |
gatus_db |
— |
GF_AUTH_GENERIC_OAUTH_API_URL |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_AUTH_URL |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_CLIENT_ID |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_CLIENT_SECRET |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_ENABLED |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_NAME |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_SCOPES |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_SKIP_ORG_ROLE_SYNC |
grafana |
— |
GF_AUTH_GENERIC_OAUTH_TOKEN_URL |
grafana |
— |
GF_AUTH_OAUTH_AUTO_LOGIN |
grafana |
— |
GF_AUTH_SIGNOUT_REDIRECT_URL |
grafana |
— |
GF_SERVER_ROOT_URL |
grafana |
— |
POSTGRES_BACKUP_RETENTION |
hass_db |
— |
POSTGRES_BACKUP_SCHEDULE |
hass_db |
— |
POSTGRES_PASSWORD |
hass_db |
— |
TZ |
hass_db |
— |
FLASK_ENV |
homehub |
— |
SECRET_KEY |
homehub |
Flask secret key |
HOMEPAGE_ALLOWED_HOSTS |
homepage |
— |
HOMEPAGE_PROXY_DISABLE_IPV6 |
homepage |
— |
DOCKER_INFLUXDB_INIT_ADMIN_TOKEN |
influxdb_peanut |
— |
DOCKER_INFLUXDB_INIT_BUCKET |
influxdb_peanut |
— |
DOCKER_INFLUXDB_INIT_MODE |
influxdb_peanut |
— |
DOCKER_INFLUXDB_INIT_ORG |
influxdb_peanut |
— |
DOCKER_INFLUXDB_INIT_PASSWORD |
influxdb_peanut |
— |
DOCKER_INFLUXDB_INIT_USERNAME |
influxdb_peanut |
— |
MEILI_MASTER_KEY |
meilisearch |
— |
GENERIC_TIMEZONE |
n8n |
— |
N8N_HOST |
n8n |
— |
N8N_PORT |
n8n |
— |
N8N_PROTOCOL |
n8n |
— |
NODE_ENV |
n8n |
— |
WEBHOOK_URL |
n8n |
— |
TZ |
node-red |
— |
PAPERLESS_REDIS |
paperless-ng |
— |
PAPERLESS_TIME_ZONE |
paperless-ng |
— |
PAPERLESS_URL |
paperless-ng |
— |
AUTH_DISABLED |
peanut |
— |
INFLUX_BUCKET |
peanut |
— |
INFLUX_HOST |
peanut |
— |
INFLUX_INTERVAL |
peanut |
— |
INFLUX_ORG |
peanut |
— |
INFLUX_TOKEN |
peanut |
— |
WEB_PORT |
peanut |
— |
PGADMIN_CONFIG_AUTHENTICATION_SOURCES |
pgadmin |
— |
PGADMIN_CONFIG_MASTER_PASSWORD_HOOK |
pgadmin |
— |
PGADMIN_CONFIG_MASTER_PASSWORD_REQUIRED |
pgadmin |
— |
PGADMIN_CONFIG_OAUTH2_AUTO_CREATE_USER |
pgadmin |
— |
PGADMIN_CONFIG_OAUTH2_CONFIG |
pgadmin |
— |
PGADMIN_DEFAULT_EMAIL |
pgadmin |
— |
PGADMIN_DEFAULT_PASSWORD |
pgadmin |
— |
POSTGRES_DB |
postgres |
— |
POSTGRES_PASSWORD |
postgres |
— |
POSTGRES_USER |
postgres |
— |
TZ |
pulse |
— |
POSTGRES_BACKUP_RETENTION |
recipes_db |
— |
POSTGRES_BACKUP_SCHEDULE |
recipes_db |
— |
POSTGRES_PASSWORD |
recipes_db |
— |
TZ |
recipes_db |
— |
AUDIO |
remmina |
— |
PGID |
remmina |
— |
PUID |
remmina |
— |
TZ |
remmina |
— |
POSTGRES_DB |
scrob-db |
— |
POSTGRES_PASSWORD |
scrob-db |
— |
POSTGRES_USER |
scrob-db |
— |
DATABASE_URL |
scrob |
— |
SECRET_KEY |
scrob |
Flask secret key |
TZ |
scrob |
— |
SCRUTINY_WEB_INFLUXDB_HOST |
scrutiny |
— |
POSTGRES_BACKUP_RETENTION |
speedtest_db |
— |
POSTGRES_BACKUP_SCHEDULE |
speedtest_db |
— |
POSTGRES_PASSWORD |
speedtest_db |
— |
TZ |
speedtest_db |
— |
APP_KEY |
speedtest-tracker |
— |
APP_URL |
speedtest-tracker |
— |
DB_CONNECTION |
speedtest-tracker |
— |
DB_DATABASE |
speedtest-tracker |
— |
DB_HOST |
speedtest-tracker |
— |
DB_PASSWORD |
speedtest-tracker |
— |
DB_PORT |
speedtest-tracker |
— |
DB_USERNAME |
speedtest-tracker |
— |
DISPLAY_TIMEZONE |
speedtest-tracker |
— |
PGID |
speedtest-tracker |
— |
PUID |
speedtest-tracker |
— |
SPEEDTEST_SCHEDULE |
speedtest-tracker |
— |
DOCKER_ENABLE_SECURITY |
stirling-pdf |
— |
INSTALL_BOOK_AND_ADVANCED_HTML_OPS |
stirling-pdf |
— |
LANGS |
stirling-pdf |
— |
PORT |
termix |
— |
6. Access & Usage
| Service | URL |
|---|---|
| Homepage | https://home-lab.micky.id.au or https://lab.m1ckyb.com |
| Gatus | https://gatus.home-lab.micky.id.au |
| Grafana | https://grafana.m1ckyb.com |
| Code Server | https://code.home-lab.micky.id.au |
| Paperless | https://paperless.home-lab.micky.id.au |
| N8N | https://n8n.m1ckyb.com |
| Speedtest | https://speedtest.home-lab.micky.id.au |
| Scrutiny | https://scrutiny.home-lab.micky.id.au |
| IT Tools | https://tools.home-lab.micky.id.au |
| Pulse (Proxmox) | https://pulse.home-lab.micky.id.au |
# Start
docker compose -f Homelab/Docker/services/compose.yaml up -d
# Check specific service
docker compose -f Homelab/Docker/services/compose.yaml logs -f grafana
7. Maintenance & Backup
# Update
docker compose -f Homelab/Docker/services/compose.yaml pull
docker compose -f Homelab/Docker/services/compose.yaml up -d
# Backup (use backup=services label to identify containers)
rsync -av /docker/services/ /backup/services/
# Database backups (gatus, hass, recipes, speedtest run auto-backups every 2h)
ls /backup/database/services/