✨ feat: Add auto-configuration creation for Docker containers - Docker Auto-Configuration System with automatic performance.toml creation - Embedded default configuration using Go embed - Smart configuration detection and validation - Docker initialization script for container setup - Container-optimized default values and performance settings

Author: JohanDevl

Dockerfile

@@ -49,6 +49,10 @@ COPY --from=builder /app/export-trakt /app/export-trakt
 # Copy locales
 COPY --from=builder /app/locales /app/locales
 
+# Copy initialization script
+COPY scripts/docker-init.sh /app/docker-init.sh
+RUN chmod +x /app/docker-init.sh
+
 # Set environment variables
 ENV EXPORT_TRAKT_EXPORT_OUTPUT_DIR=/app/exports
 ENV EXPORT_TRAKT_LOGGING_FILE=/app/logs/export.log
@@ -59,8 +63,8 @@ USER appuser
 # Create volumes for persistent data
 VOLUME ["/app/config", "/app/logs", "/app/exports"]
 
-# Set entrypoint
-ENTRYPOINT ["/app/export-trakt"]
+# Set entrypoint to initialization script
+ENTRYPOINT ["/app/docker-init.sh"]
 
 # Default command if none is provided
 CMD ["--help"]

docker-compose.example.yml

@@ -0,0 +1,178 @@
+version: "3.8"
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                            EXPORT TRAKT FOR LETTERBOXD
+#                              Docker Compose Example
+# ═══════════════════════════════════════════════════════════════════════════════
+#
+# 🐳 Docker Compose Configuration
+#    This example shows how to run Export Trakt for Letterboxd with
+#    automatic configuration file creation.
+#
+# 📋 Instructions:
+#   1. Copy this file to docker-compose.yml
+#   2. Set your Trakt.tv API credentials in the environment section
+#   3. Customize volumes and environment variables as needed
+#   4. Run: docker-compose up
+#
+# ═══════════════════════════════════════════════════════════════════════════════
+
+services:
+  export-trakt:
+    # Use the latest image or build from source
+    image: johandevl/export-trakt-4-letterboxd:latest
+    # Uncomment to build from source:
+    # build: .
+
+    container_name: export-trakt-letterboxd
+
+    # Environment variables for configuration
+    environment:
+      # 🔑 Required: Trakt.tv API Credentials
+      # Get these from: https://trakt.tv/oauth/applications
+      TRAKT_CLIENT_ID: "your_trakt_client_id_here"
+      TRAKT_CLIENT_SECRET: "your_trakt_client_secret_here"
+
+      # 🔐 Optional: Access token for authenticated requests
+      # TRAKT_ACCESS_TOKEN: "your_access_token_here"
+
+      # 🛡️  Optional: Encryption key (auto-generated if not provided)
+      # ENCRYPTION_KEY: "your_base64_encryption_key_here"
+
+      # 🌍 Optional: Timezone for exports
+      TZ: "UTC"
+
+      # 📝 Optional: Logging level
+      EXPORT_TRAKT_LOGGING_LEVEL: "info"
+
+      # 🔒 Security settings (recommended for production)
+      EXPORT_TRAKT_SECURITY_ENABLED: "true"
+      EXPORT_TRAKT_SECURITY_KEYRING_BACKEND: "env"
+      EXPORT_TRAKT_SECURITY_AUDIT_LOGGING: "true"
+      EXPORT_TRAKT_SECURITY_REQUIRE_HTTPS: "true"
+
+    # Persistent volumes
+    volumes:
+      # Configuration files (auto-created if not present)
+      - ./config:/app/config
+
+      # Log files
+      - ./logs:/app/logs
+
+      # Export output files
+      - ./exports:/app/exports
+
+      # Optional: Mount custom performance.toml
+      # - ./custom-performance.toml:/app/config/performance.toml:ro
+
+    # Resource limits (adjust based on your needs)
+    deploy:
+      resources:
+        limits:
+          memory: 512M
+          cpus: "1.0"
+        reservations:
+          memory: 256M
+          cpus: "0.5"
+
+    # Restart policy
+    restart: unless-stopped
+
+    # Network mode (optional)
+    # network_mode: "bridge"
+
+    # Optional: Expose profiling port for monitoring
+    # ports:
+    #   - "6060:6060"  # pprof profiling endpoint
+
+    # Health check (optional)
+    healthcheck:
+      test: ["CMD", "/app/export-trakt", "version"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 40s
+
+    # User (runs as non-root)
+    user: "65532:65532" # appuser:appgroup
+
+    # Security options
+    security_opt:
+      - no-new-privileges:true
+    read_only: true
+    tmpfs:
+      - /tmp:noexec,nosuid,size=100m
+
+    # Command to run (examples)
+    # Default: Shows help
+    command: ["--help"]
+
+    # Uncomment one of these to run specific exports:
+    # command: ["export", "--type", "movies", "--output", "/app/exports"]
+    # command: ["export", "--type", "shows", "--output", "/app/exports"]
+    # command: ["export", "--type", "all", "--output", "/app/exports"]
+# ═══════════════════════════════════════════════════════════════════════════════
+#                                    VOLUMES
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Optional: Use named volumes instead of bind mounts
+# volumes:
+#   export_trakt_config:
+#     driver: local
+#   export_trakt_logs:
+#     driver: local
+#   export_trakt_exports:
+#     driver: local
+
+# To use named volumes, replace the volumes section above with:
+# volumes:
+#   - export_trakt_config:/app/config
+#   - export_trakt_logs:/app/logs
+#   - export_trakt_exports:/app/exports
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                                    NETWORKS
+# ═══════════════════════════════════════════════════════════════════════════════
+
+# Optional: Custom network configuration
+# networks:
+#   export_trakt_network:
+#     driver: bridge
+#     ipam:
+#       config:
+#         - subnet: 172.20.0.0/16
+
+# ═══════════════════════════════════════════════════════════════════════════════
+#                                 USAGE EXAMPLES
+# ═══════════════════════════════════════════════════════════════════════════════
+#
+# 🚀 Quick Start:
+#   1. Set your Trakt credentials in the environment section
+#   2. Run: docker-compose up
+#   3. Configuration files will be auto-created in ./config/
+#   4. Exports will be saved to ./exports/
+#
+# 🔧 Configuration:
+#   - Edit ./config/config.toml for main settings
+#   - Edit ./config/performance.toml for performance tuning (auto-created)
+#   - View logs in ./logs/
+#
+# 📊 Export Commands:
+#   docker-compose run --rm export-trakt export --type movies
+#   docker-compose run --rm export-trakt export --type shows
+#   docker-compose run --rm export-trakt export --type all
+#
+# 🔍 Monitoring:
+#   docker-compose logs -f export-trakt
+#   docker-compose exec export-trakt /app/export-trakt status
+#
+# 🛠️  Development:
+#   # Enable profiling
+#   # Uncomment ports section and set EXPORT_TRAKT_MONITORING_PROFILING_PORT=6060
+#   # Access profiling at http://localhost:6060/debug/pprof/
+#
+# 🧹 Cleanup:
+#   docker-compose down
+#   docker-compose down -v  # Also removes volumes
+#
+# ═══════════════════════════════════════════════════════════════════════════════