feat: add Synology NAS deployment support

- docker-compose.synology.yml: simplified config (HTTP only, no Caddy,
  relative paths, optional local game volumes)
- .github/workflows/build-synology-image.yml: automated AMD64 image build
  on push, exports .tar.gz artifact (30-day retention)
- scripts/build-for-synology.ps1: manual PowerShell build script
- docs/synology-deployment.md: complete deployment guide (Container Manager
  UI + SSH methods, troubleshooting)
- docker-compose.yml: use BACKLOGIA_DATA_DIR variable for flexible volume
  paths (host-side only, no Python code change required)
- .env.example: document BACKLOGIA_DATA_DIR variable

Author: davidp57

.env.example

@@ -30,6 +30,11 @@ GOG_DB_DIR=C:/ProgramData/GOG.com/Galaxy/storage
 # LOCAL_GAMES_DIR_4=
 # LOCAL_GAMES_DIR_5=
 
+# Data directory for storing Backlogia's database and config files
+# This should be a persistent volume in production to retain data across container restarts
+# For development, you can set this to a local directory (e.g., ./data)
+# BACKLOGIA_DATA_DIR=/path/to/backlogia/root/dir
+
 # Authentication (optional)
 # ENABLE_AUTH=true
 # SESSION_EXPIRY_DAYS=30

.github/workflows/build-synology-image.yml

@@ -0,0 +1,33 @@
+name: Build Docker Image for Synology
+
+on:
+  push:
+    branches: [deploy-synology]
+  workflow_dispatch:  # Allow manual trigger
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Build Docker image
+        run: docker build -t backlogia:latest .
+
+      - name: Export image to TAR
+        run: docker save backlogia:latest -o backlogia.tar
+
+      - name: Compress TAR file
+        run: gzip backlogia.tar
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: backlogia-docker-image
+          path: backlogia.tar.gz
+          retention-days: 30
+          compression-level: 0  # Already compressed with gzip

docker-compose.synology.yml

@@ -0,0 +1,43 @@
+# Docker Compose configuration for Synology NAS deployment
+# This file is OPTIONAL - the recommended method is to use Synology Container Manager UI
+#
+# This configuration is for advanced users who prefer using docker-compose via SSH
+# For most users, importing the image via Container Manager UI is simpler
+
+services:
+  backlogia:
+    image: backlogia:latest  # Image imported from GitHub Actions artifact
+    container_name: backlogia
+    ports:
+      - "5050:5050"
+    networks:
+      - backlogia-net
+    volumes:
+      # Persistent data - uses relative "./data" path by default
+      # Users can modify these paths via Synology Container Manager UI or by editing this file
+      - ./data:/data
+      - ./data/legendary:/root/.config/legendary
+      - ./data/nile:/root/.config/nile
+      - ./logs:/app/logs
+
+      # Optional volumes for local game directories (uncomment if needed)
+      # Replace with your actual game folder paths on the NAS
+      # - /volume1/games:/local-games-1:ro
+      # - /volume1/media/games:/local-games-2:ro
+      # - /volume2/games:/local-games-3:ro
+      # - /volume3/games:/local-games-4:ro
+      # - /volume4/games:/local-games-5:ro
+    environment:
+      # Core application settings
+      - DATABASE_PATH=/data/game_library.db
+      - PORT=5050
+      - DEBUG=false
+
+      # Note: API keys (Steam, IGDB, itch.io, Humble, Battle.net, etc.)
+      # are NOT required here. They are configured via the web Settings UI
+      # at http://[NAS-IP]:5050/settings and stored in the SQLite database.
+    restart: unless-stopped
+
+networks:
+  backlogia-net:
+    driver: bridge

docker-compose.yml

@@ -7,10 +7,11 @@ services:
     networks:
       - backlogia-net
     volumes:
-      - ./data:/data
-      - ./data/legendary:/root/.config/legendary
-      - ./data/nile:/root/.config/nile
-      - ${GOG_DB_DIR:-./.empty}:/gog:ro
+      - ${BACKLOGIA_DATA_DIR:-.}/data:/data
+      - ${BACKLOGIA_DATA_DIR:-.}/data/legendary:/root/.config/legendary
+      - ${BACKLOGIA_DATA_DIR:-.}/data/nile:/root/.config/nile
+      - ${BACKLOGIA_DATA_DIR:-.}/logs:/app/logs
+      - ${GOG_DB_DIR:-.}:/gog:ro
       # Local game folders (up to 5 by default, add more if needed)
       - ${LOCAL_GAMES_DIR_1:-./.empty}:/local-games-1:ro
       - ${LOCAL_GAMES_DIR_2:-./.empty}:/local-games-2:ro
@@ -58,8 +59,8 @@ services:
       - "443:443"
     volumes:
       - ./Caddyfile:/etc/caddy/Caddyfile:ro
-      - ./data/caddy_data:/data
-      - ./data/caddy_config:/config
+      - ${BACKLOGIA_DATA_DIR:-./data}/caddy_data:/data
+      - ${BACKLOGIA_DATA_DIR:-./data}/caddy_config:/config
     networks:
       - backlogia-net
     restart: unless-stopped