🐳 docker

README.md

@@ -17,6 +17,9 @@ sunday/
 ├── app.py                    # Main Flask application
 ├── comics_data.py            # Comic data (edit this to add comics)
 ├── requirements.txt          # Python dependencies
+├── Dockerfile                # Production Docker image
+├── docker-compose.yml        # Docker Compose configuration
+├── .dockerignore             # Docker build exclusions
 ├── scripts/                  # Utility scripts
 │   ├── add_comic.py         # Script to add new comic entries
 │   └── generate_rss.py      # Script to generate RSS feed
@@ -108,15 +111,54 @@ This creates/updates `static/feed.rss`
 
 ## Production Deployment
 
-For production, you should **NOT** use Flask's built-in development server. Instead:
+For production, you should **NOT** use Flask's built-in development server. Choose one of the following deployment methods:
 
-### 1. Generate a Secure Secret Key
+### Option 1: Docker (Recommended)
+
+**1. Generate a secure secret key:**
+```bash
+python -c "import secrets; print(secrets.token_hex(32))"
+```
+
+**2. Create a `.env` file:**
+```bash
+SECRET_KEY=your-generated-secret-key-here
+```
+
+**3. Build and run with Docker Compose:**
+```bash
+docker-compose up -d
+```
+
+**Or build and run manually:**
+```bash
+# Build the image
+docker build -t sunday-comics .
+
+# Run the container
+docker run -d \
+  -p 3000:3000 \
+  -e SECRET_KEY="your-secret-key" \
+  -v $(pwd)/comics_data.py:/app/comics_data.py:ro \
+  -v $(pwd)/static/images:/app/static/images:ro \
+  --name sunday-comics \
+  sunday-comics
+```
+
+**View logs:**
+```bash
+docker-compose logs -f
+```
+
+### Option 2: Manual Deployment with Gunicorn
+
+**1. Generate a Secure Secret Key**
 
 ```bash
 python -c "import secrets; print(secrets.token_hex(32))"
 ```
 
-### 2. Set Environment Variables
+**2. Set Environment Variables**
 
 ```bash
 export SECRET_KEY="generated-secret-key-from-above"
@@ -124,7 +166,7 @@ export DEBUG=False
 export PORT=3000
 ```
 
-### 3. Use a Production WSGI Server
+**3. Use a Production WSGI Server**
 
 **Install Gunicorn:**
 ```bash
@@ -136,17 +178,17 @@ pip install gunicorn
 gunicorn app:app --bind 0.0.0.0:3000 --workers 4
 ```
 
-### 4. Use a Reverse Proxy (Recommended)
+### Using a Reverse Proxy (Recommended)
 
-Set up Nginx or another reverse proxy in front of Gunicorn for:
+Set up Nginx or another reverse proxy in front of your app for:
 - HTTPS/SSL termination
 - Static file serving
 - Load balancing
 - Better security
 
-### 5. Additional Production Considerations
+### Additional Production Considerations
 
-- Use a process manager (systemd, supervisor)
+- Use a process manager (systemd, supervisor) for non-Docker deployments
 - Set appropriate file permissions
 - Enable HTTPS with Let's Encrypt
 - Consider using a CDN for static assets