Update media-management compose: unified Sablier groups, x-dockge format

- Changed all Sablier groups to ${SERVER_HOSTNAME}-arr for coordinated lazy loading
- Moved x-dockge URLs to top-level section with urls list format
- Added both HTTPS and localhost URLs for service discovery
- Updated guidelines and instructions to reflect new x-dockge format
This commit is contained in:
EZ-Homelab
2026-01-24 14:46:50 -05:00
parent e533b6cdeb
commit a0bb477d8c
3 changed files with 126 additions and 20 deletions

View File

@@ -65,11 +65,18 @@ labels:
- "traefik.http.routers.SERVICE.tls.certresolver=letsencrypt" # Uses wildcard cert - "traefik.http.routers.SERVICE.tls.certresolver=letsencrypt" # Uses wildcard cert
- "traefik.http.routers.SERVICE.middlewares=authelia@docker" # SSO protection (comment out to disable) - "traefik.http.routers.SERVICE.middlewares=authelia@docker" # SSO protection (comment out to disable)
- "traefik.http.services.SERVICE.loadbalancer.server.port=PORT" # If not default - "traefik.http.services.SERVICE.loadbalancer.server.port=PORT" # If not default
- "x-dockge.url=https://SERVICE.${DOMAIN}" # Service discovery in Dockge
# Optional: Sablier lazy loading (comment out to disable) # Optional: Sablier lazy loading (comment out to disable)
# - "sablier.enable=true" - "sablier.enable=true"
# - "sablier.group=core-SERVICE" - "sablier.group=${SERVER_HOSTNAME}-SERVICE" # Use -arr for media stacks
# - "sablier.start-on-demand=true" - "sablier.start-on-demand=true"
```
Add x-dockge section at the bottom of the compose file:
```yaml
x-dockge:
urls:
- https://SERVICE.${DOMAIN} # HTTPS access via Traefik
- http://localhost:PORT # Direct local access
``` ```
### 3. Resource Management ### 3. Resource Management
@@ -178,10 +185,14 @@ services:
- "traefik.http.routers.service-name.tls.certresolver=letsencrypt" - "traefik.http.routers.service-name.tls.certresolver=letsencrypt"
- "traefik.http.routers.service-name.middlewares=authelia@docker" # SSO enabled by default - "traefik.http.routers.service-name.middlewares=authelia@docker" # SSO enabled by default
- "traefik.http.services.service-name.loadbalancer.server.port=8080" # If non-standard port - "traefik.http.services.service-name.loadbalancer.server.port=8080" # If non-standard port
- "x-dockge.url=https://service.${DOMAIN}" # Service discovery
- "homelab.category=category-name" - "homelab.category=category-name"
- "homelab.description=Service description" - "homelab.description=Service description"
x-dockge:
urls:
- https://service.${DOMAIN}
- http://localhost:8080
volumes: volumes:
service-data: service-data:
driver: local driver: local
@@ -229,11 +240,15 @@ labels:
- "traefik.http.routers.jellyfin.entrypoints=websecure" - "traefik.http.routers.jellyfin.entrypoints=websecure"
- "traefik.http.routers.jellyfin.tls.certresolver=letsencrypt" - "traefik.http.routers.jellyfin.tls.certresolver=letsencrypt"
# NO authelia middleware - direct access for apps/devices # NO authelia middleware - direct access for apps/devices
- "x-dockge.url=https://jellyfin.${DOMAIN}"
# Optional: Sablier lazy loading (uncomment to enable) # Optional: Sablier lazy loading (uncomment to enable)
# - "sablier.enable=true" # - "sablier.enable=true"
# - "sablier.group=media-jellyfin" # - "sablier.group=media-jellyfin"
# - "sablier.start-on-demand=true" # - "sablier.start-on-demand=true"
x-dockge:
urls:
- https://jellyfin.${DOMAIN}
- http://localhost:8096
``` ```
## Modifying Existing Services ## Modifying Existing Services
@@ -292,11 +307,13 @@ Apply limits to all services to prevent resource exhaustion:
- **Media services**: High limits (2-4 CPU, 4-8GB RAM) - **Media services**: High limits (2-4 CPU, 4-8GB RAM)
- **Always set reservations** for guaranteed minimum resources - **Always set reservations** for guaranteed minimum resources
### x-dockge.url Labels ### x-dockge Section
Include service discovery labels for Dockge UI: Include service discovery section for Dockge UI:
```yaml ```yaml
labels: x-dockge:
- "x-dockge.url=https://service.${DOMAIN}" # Shows direct link in Dockge urls:
- https://service.${DOMAIN} # HTTPS access via Traefik
- http://localhost:PORT # Direct local access
``` ```
## Key Documentation References ## Key Documentation References

View File

@@ -25,7 +25,7 @@ services:
sonarr: sonarr:
image: linuxserver/sonarr:4.0.0 image: linuxserver/sonarr:4.0.0
container_name: sonarr container_name: sonarr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -46,6 +46,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=TV show management and automation" - "homelab.description=TV show management and automation"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -55,12 +56,15 @@ services:
- "traefik.http.routers.sonarr.tls.certresolver=letsencrypt" - "traefik.http.routers.sonarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.sonarr.middlewares=authelia@docker" - "traefik.http.routers.sonarr.middlewares=authelia@docker"
- "traefik.http.services.sonarr.loadbalancer.server.port=8989" - "traefik.http.services.sonarr.loadbalancer.server.port=8989"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Radarr - Movie automation # Radarr - Movie automation
# Access at: https://radarr.yourdomain.duckdns.org # Access at: https://radarr.yourdomain.duckdns.org
radarr: radarr:
image: linuxserver/radarr:5.2.6 image: linuxserver/radarr:5.2.6
container_name: radarr container_name: radarr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -81,6 +85,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Movie management and automation" - "homelab.description=Movie management and automation"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -90,12 +95,15 @@ services:
- "traefik.http.routers.radarr.tls.certresolver=letsencrypt" - "traefik.http.routers.radarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.radarr.middlewares=authelia@docker" - "traefik.http.routers.radarr.middlewares=authelia@docker"
- "traefik.http.services.radarr.loadbalancer.server.port=7878" - "traefik.http.services.radarr.loadbalancer.server.port=7878"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Prowlarr - Indexer manager # Prowlarr - Indexer manager
# Access at: https://prowlarr.yourdomain.duckdns.org # Access at: https://prowlarr.yourdomain.duckdns.org
prowlarr: prowlarr:
image: linuxserver/prowlarr:1.11.4 image: linuxserver/prowlarr:1.11.4
container_name: prowlarr container_name: prowlarr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -114,6 +122,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Indexer manager for Sonarr/Radarr" - "homelab.description=Indexer manager for Sonarr/Radarr"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -123,12 +132,15 @@ services:
- "traefik.http.routers.prowlarr.tls.certresolver=letsencrypt" - "traefik.http.routers.prowlarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.prowlarr.middlewares=authelia@docker" - "traefik.http.routers.prowlarr.middlewares=authelia@docker"
- "traefik.http.services.prowlarr.loadbalancer.server.port=9696" - "traefik.http.services.prowlarr.loadbalancer.server.port=9696"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Readarr - Ebook and audiobook management # Readarr - Ebook and audiobook management
# Access at: https://readarr.${DOMAIN} # Access at: https://readarr.${DOMAIN}
readarr: readarr:
image: linuxserver/readarr:0.4.19-nightly image: linuxserver/readarr:0.4.19-nightly
container_name: readarr container_name: readarr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -149,6 +161,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Ebook and audiobook management" - "homelab.description=Ebook and audiobook management"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -158,12 +171,15 @@ services:
- "traefik.http.routers.readarr.tls.certresolver=letsencrypt" - "traefik.http.routers.readarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.readarr.middlewares=authelia@docker" - "traefik.http.routers.readarr.middlewares=authelia@docker"
- "traefik.http.services.readarr.loadbalancer.server.port=8787" - "traefik.http.services.readarr.loadbalancer.server.port=8787"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Lidarr - Music collection manager # Lidarr - Music collection manager
# Access at: https://lidarr.${DOMAIN} # Access at: https://lidarr.${DOMAIN}
lidarr: lidarr:
image: linuxserver/lidarr:2.0.7 image: linuxserver/lidarr:2.0.7
container_name: lidarr container_name: lidarr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -184,6 +200,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Music collection manager" - "homelab.description=Music collection manager"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -193,12 +210,15 @@ services:
- "traefik.http.routers.lidarr.tls.certresolver=letsencrypt" - "traefik.http.routers.lidarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.lidarr.middlewares=authelia@docker" - "traefik.http.routers.lidarr.middlewares=authelia@docker"
- "traefik.http.services.lidarr.loadbalancer.server.port=8686" - "traefik.http.services.lidarr.loadbalancer.server.port=8686"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Lazy Librarian - Book manager # Lazy Librarian - Book manager
# Access at: https://lazylibrarian.${DOMAIN} # Access at: https://lazylibrarian.${DOMAIN}
lazylibrarian: lazylibrarian:
image: linuxserver/lazylibrarian:latest image: linuxserver/lazylibrarian:latest
container_name: lazylibrarian container_name: lazylibrarian
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -220,6 +240,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Book download automation" - "homelab.description=Book download automation"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -229,12 +250,15 @@ services:
- "traefik.http.routers.lazylibrarian.tls.certresolver=letsencrypt" - "traefik.http.routers.lazylibrarian.tls.certresolver=letsencrypt"
- "traefik.http.routers.lazylibrarian.middlewares=authelia@docker" - "traefik.http.routers.lazylibrarian.middlewares=authelia@docker"
- "traefik.http.services.lazylibrarian.loadbalancer.server.port=5299" - "traefik.http.services.lazylibrarian.loadbalancer.server.port=5299"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Mylar3 - Comic book manager # Mylar3 - Comic book manager
# Access at: https://mylar.${DOMAIN} # Access at: https://mylar.${DOMAIN}
mylar3: mylar3:
image: linuxserver/mylar3:latest image: linuxserver/mylar3:latest
container_name: mylar3 container_name: mylar3
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -255,6 +279,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Comic book collection manager" - "homelab.description=Comic book collection manager"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -264,12 +289,15 @@ services:
- "traefik.http.routers.mylar.tls.certresolver=letsencrypt" - "traefik.http.routers.mylar.tls.certresolver=letsencrypt"
- "traefik.http.routers.mylar.middlewares=authelia@docker" - "traefik.http.routers.mylar.middlewares=authelia@docker"
- "traefik.http.services.mylar.loadbalancer.server.port=8090" - "traefik.http.services.mylar.loadbalancer.server.port=8090"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Jellyseerr - Request management for Jellyfin/Plex # Jellyseerr - Request management for Jellyfin/Plex
# Access at: https://jellyseerr.${DOMAIN} # Access at: https://jellyseerr.${DOMAIN}
jellyseerr: jellyseerr:
image: fallenbagel/jellyseerr:latest image: fallenbagel/jellyseerr:latest
container_name: jellyseerr container_name: jellyseerr
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -287,6 +315,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Media request management" - "homelab.description=Media request management"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -296,6 +325,9 @@ services:
- "traefik.http.routers.jellyseerr.tls.certresolver=letsencrypt" - "traefik.http.routers.jellyseerr.tls.certresolver=letsencrypt"
- "traefik.http.routers.jellyseerr.middlewares=authelia@docker" - "traefik.http.routers.jellyseerr.middlewares=authelia@docker"
- "traefik.http.services.jellyseerr.loadbalancer.server.port=5055" - "traefik.http.services.jellyseerr.loadbalancer.server.port=5055"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# FlareSolverr - Cloudflare bypass for Prowlarr # FlareSolverr - Cloudflare bypass for Prowlarr
# No web UI - used by Prowlarr # No web UI - used by Prowlarr
flaresolverr: flaresolverr:
@@ -315,7 +347,7 @@ services:
tdarr-server: tdarr-server:
image: ghcr.io/haveagitgat/tdarr:latest image: ghcr.io/haveagitgat/tdarr:latest
container_name: tdarr-server container_name: tdarr-server
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -342,6 +374,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Distributed transcoding server" - "homelab.description=Distributed transcoding server"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -351,6 +384,9 @@ services:
- "traefik.http.routers.tdarr.tls.certresolver=letsencrypt" - "traefik.http.routers.tdarr.tls.certresolver=letsencrypt"
- "traefik.http.routers.tdarr.middlewares=authelia@docker" - "traefik.http.routers.tdarr.middlewares=authelia@docker"
- "traefik.http.services.tdarr.loadbalancer.server.port=8265" - "traefik.http.services.tdarr.loadbalancer.server.port=8265"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
# Tdarr Node - Transcoding worker # Tdarr Node - Transcoding worker
# No web UI - controlled by server # No web UI - controlled by server
tdarr-node: tdarr-node:
@@ -381,7 +417,7 @@ services:
unmanic: unmanic:
image: josh5/unmanic:latest image: josh5/unmanic:latest
container_name: unmanic container_name: unmanic
restart: unless-stopped restart: no
networks: networks:
- media-network - media-network
- homelab-network - homelab-network
@@ -402,6 +438,7 @@ services:
# Service metadata # Service metadata
- "homelab.category=media" - "homelab.category=media"
- "homelab.description=Library optimization and transcoding" - "homelab.description=Library optimization and transcoding"
- "com.centurylinklabs.watchtower.enable=true"
# Traefik reverse proxy (comment/uncomment to disable/enable) # Traefik reverse proxy (comment/uncomment to disable/enable)
# If Traefik is on a remote server: these labels are NOT USED; # If Traefik is on a remote server: these labels are NOT USED;
# configure external yml files in /traefik/dynamic folder instead. # configure external yml files in /traefik/dynamic folder instead.
@@ -411,6 +448,31 @@ services:
- "traefik.http.routers.unmanic.tls.certresolver=letsencrypt" - "traefik.http.routers.unmanic.tls.certresolver=letsencrypt"
- "traefik.http.routers.unmanic.middlewares=authelia@docker" - "traefik.http.routers.unmanic.middlewares=authelia@docker"
- "traefik.http.services.unmanic.loadbalancer.server.port=8888" - "traefik.http.services.unmanic.loadbalancer.server.port=8888"
- "sablier.enable=true"
- "sablier.group=${SERVER_HOSTNAME}-arr"
- "sablier.start-on-demand=true"
x-dockge:
urls:
- https://sonarr.${DOMAIN}
- http://localhost:8989
- https://radarr.${DOMAIN}
- http://localhost:7878
- https://prowlarr.${DOMAIN}
- http://localhost:9696
- https://readarr.${DOMAIN}
- http://localhost:8787
- https://lidarr.${DOMAIN}
- http://localhost:8686
- https://lazylibrarian.${DOMAIN}
- http://localhost:5299
- https://mylar.${DOMAIN}
- http://localhost:8090
- https://jellyseerr.${DOMAIN}
- http://localhost:5055
- https://tdarr.${DOMAIN}
- http://localhost:8265
- https://unmanic.${DOMAIN}
- http://localhost:8888
networks: networks:
media-network: media-network:
external: true external: true

View File

@@ -158,6 +158,16 @@ services:
- `sablier.group=${SERVER_HOSTNAME}-myservice` - Groups containers for coordinated startup - `sablier.group=${SERVER_HOSTNAME}-myservice` - Groups containers for coordinated startup
- `sablier.start-on-demand=true` - Starts containers only when accessed - `sablier.start-on-demand=true` - Starts containers only when accessed
**x-dockge Section:**
At the bottom of the compose file, add a top-level `x-dockge` section for service discovery in Dockge:
```yaml
x-dockge:
urls:
- https://myservice.${DOMAIN}
- http://localhost:8080 # Direct local access
```
### If Traefik is on a Remote Server, configure routes & services on the Remote Server ### If Traefik is on a Remote Server, configure routes & services on the Remote Server
When Traefik runs on a separate server from your application services, you cannot use Docker labels for configuration. Instead, create YAML files in the Traefik server's `dynamic/` directory to define routes and services. When Traefik runs on a separate server from your application services, you cannot use Docker labels for configuration. Instead, create YAML files in the Traefik server's `dynamic/` directory to define routes and services.
@@ -535,6 +545,23 @@ services:
- "sablier.group=${SERVER_HOSTNAME}-service-name" - "sablier.group=${SERVER_HOSTNAME}-service-name"
- "sablier.start-on-demand=true" - "sablier.start-on-demand=true"
``` ```
**Add x-dockge section at the bottom of the compose file (before networks):**
```yaml
x-dockge:
urls:
- https://service-name.${DOMAIN}
- http://localhost:8080
volumes:
service-data:
driver: local
networks:
traefik-network:
external: true
```
If Traefik & Sablier are on a remote server: If Traefik & Sablier are on a remote server:
* Comment out the traefik labels since they won't be used, don't delete them. * Comment out the traefik labels since they won't be used, don't delete them.
* Notify user to add the service and middleware to the traefic external host yml file, and the sablier.yml file. * Notify user to add the service and middleware to the traefic external host yml file, and the sablier.yml file.