Fixed: Docker config file support and documentation

Critical fixes for v1.4.0:
- s6 run script now passes --config /config/config.json to application
- s6 service uses symlink instead of text file (fixes exec format error)
- init script validates config file OR environment variables (not requiring both)
- Added troubleshooting tools (procps, htop, vim-tiny)
- Updated README with correct /config mount pattern and Docker Compose examples

This hotfix resolves container startup failures and improves Docker deployment experience.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: bakerboy448

Dockerfile

@@ -32,6 +32,9 @@ RUN apt-get update && apt-get install -y --no-install-recommends \
     ca-certificates \
     curl \
     xz-utils \
+    procps \
+    htop \
+    vim-tiny \
     && rm -rf /var/lib/apt/lists/*
 
 # Install s6-overlay for proper init and user management
@@ -73,41 +76,37 @@ RUN mkdir -p /config /config/data /config/logs /app /etc/s6-overlay/s6-rc.d/modl
 RUN echo '#!/command/with-contenv bash\n\
 set -e\n\
 \n\
-# Validate critical environment variables\n\
-echo "Validating required environment variables..."\n\
-\n\
-missing_vars=()\n\
-\n\
-[ -z "$REDDIT_CLIENT_ID" ] && missing_vars+=("REDDIT_CLIENT_ID")\n\
-[ -z "$REDDIT_CLIENT_SECRET" ] && missing_vars+=("REDDIT_CLIENT_SECRET")\n\
-[ -z "$REDDIT_USERNAME" ] && missing_vars+=("REDDIT_USERNAME")\n\
-[ -z "$REDDIT_PASSWORD" ] && missing_vars+=("REDDIT_PASSWORD")\n\
-[ -z "$SOURCE_SUBREDDIT" ] && missing_vars+=("SOURCE_SUBREDDIT")\n\
-\n\
-if [ ${#missing_vars[@]} -ne 0 ]; then\n\
-    echo "ERROR: Missing required environment variables:" >&2\n\
-    printf "  - %s\n" "${missing_vars[@]}" >&2\n\
-    echo "" >&2\n\
-    echo "Please set all required environment variables and restart the container." >&2\n\
-    exit 1\n\
+# Validate that we have either config file OR environment variables\n\
+if [ ! -f /config/config.json ]; then\n\
+    echo "No config file found at /config/config.json, checking environment variables..."\n\
+    missing_vars=()\n\
+    [ -z "$REDDIT_CLIENT_ID" ] && missing_vars+=("REDDIT_CLIENT_ID")\n\
+    [ -z "$REDDIT_CLIENT_SECRET" ] && missing_vars+=("REDDIT_CLIENT_SECRET")\n\
+    [ -z "$REDDIT_USERNAME" ] && missing_vars+=("REDDIT_USERNAME")\n\
+    [ -z "$REDDIT_PASSWORD" ] && missing_vars+=("REDDIT_PASSWORD")\n\
+    [ -z "$SOURCE_SUBREDDIT" ] && missing_vars+=("SOURCE_SUBREDDIT")\n\
+    if [ ${#missing_vars[@]} -ne 0 ]; then\n\
+        echo "ERROR: No config file and missing required environment variables:" >&2\n\
+        printf "  - %s\n" "${missing_vars[@]}" >&2\n\
+        echo "" >&2\n\
+        echo "Either mount a config file to /config/config.json OR set environment variables." >&2\n\
+        exit 1\n\
+    fi\n\
+    echo "Using environment variables for configuration"\n\
+else\n\
+    echo "Using config file: /config/config.json"\n\
 fi\n\
 \n\
-echo "All required environment variables are set."\n\
-\n\
 PUID=${PUID:-1000}\n\
 PGID=${PGID:-1000}\n\
-\n\
 echo "Setting UID:GID to ${PUID}:${PGID}"\n\
 \n\
-# Update user and group IDs\n\
 groupmod -o -g "$PGID" modlogbot\n\
 usermod -o -u "$PUID" modlogbot\n\
 \n\
-# Fix ownership\n\
-echo "Fixing ownership of /config and /app"\n\
-chown -R modlogbot:modlogbot /config /app\n\
+echo "Fixing ownership of /config"\n\
+chown -R modlogbot:modlogbot /config\n\
 \n\
-# Ensure data directory has correct permissions\n\
 if [ ! -f /config/data/modlog.db ]; then\n\
     echo "Initializing database directory"\n\
     touch /config/data/modlog.db\n\
@@ -118,14 +117,14 @@ fi' > /etc/s6-overlay/scripts/init-modlogbot-run && \
 # Create s6 service run script
 RUN echo '#!/command/with-contenv bash\n\
 cd /app\n\
-exec s6-setuidgid modlogbot python modlog_wiki_publisher.py --continuous' > /etc/s6-overlay/scripts/modlog-bot-run && \
+exec s6-setuidgid modlogbot python modlog_wiki_publisher.py --config /config/config.json --continuous' > /etc/s6-overlay/scripts/modlog-bot-run && \
     chmod +x /etc/s6-overlay/scripts/modlog-bot-run
 
 # Setup s6 service definitions
 RUN echo 'oneshot' > /etc/s6-overlay/s6-rc.d/init-modlogbot/type && \
     echo '/etc/s6-overlay/scripts/init-modlogbot-run' > /etc/s6-overlay/s6-rc.d/init-modlogbot/up && \
     echo 'longrun' > /etc/s6-overlay/s6-rc.d/modlog-bot/type && \
-    echo '/etc/s6-overlay/scripts/modlog-bot-run' > /etc/s6-overlay/s6-rc.d/modlog-bot/run && \
+    ln -s /etc/s6-overlay/scripts/modlog-bot-run /etc/s6-overlay/s6-rc.d/modlog-bot/run && \
     echo 'init-modlogbot' > /etc/s6-overlay/s6-rc.d/modlog-bot/dependencies && \
     touch /etc/s6-overlay/s6-rc.d/user/contents.d/init-modlogbot && \
     touch /etc/s6-overlay/s6-rc.d/user/contents.d/modlog-bot

README.md

@@ -228,53 +228,111 @@ The database includes comprehensive moderation data with full transparency:
 
 ### Quick Start with Docker
 
+The recommended approach is to use a config file for all settings:
+
 ```bash
-# Using Docker Compose (recommended)
-docker-compose up -d
+# 1. Create config directory structure
+mkdir -p ./config/data ./config/logs
+
+# 2. Create config.json from template
+cp config_template.json ./config/config.json
+# Edit ./config/config.json with your credentials
 
-# Using Docker directly
+# 3. Run with config file (recommended)
 docker run -d \
   --name reddit-modlog \
+  -e PUID=1000 \
+  -e PGID=1000 \
+  -v ./config:/config \
+  ghcr.io/bakerboy448/redditmodlog:latest
+
+# 4. Using Docker Compose (recommended)
+docker compose up -d
+```
+
+**What gets mounted to `/config`:**
+- `config.json` - Your configuration file (auto-updated with new defaults on upgrades)
+- `data/modlog.db` - SQLite database (persistent)
+- `logs/` - Per-subreddit log files
+
+### Alternative: Environment Variables
+
+You can use environment variables instead of a config file:
+
+```bash
+docker run -d \
+  --name reddit-modlog \
+  -e PUID=1000 \
+  -e PGID=1000 \
   -e REDDIT_CLIENT_ID=your_client_id \
   -e REDDIT_CLIENT_SECRET=your_client_secret \
   -e REDDIT_USERNAME=your_username \
   -e REDDIT_PASSWORD=your_password \
   -e SOURCE_SUBREDDIT=yoursubreddit \
-  -e PUID=1000 \
-  -e PGID=1000 \
-  -v ./data:/config/data \
-  -v ./logs:/config/logs \
+  -v ./config:/config \
   ghcr.io/bakerboy448/redditmodlog:latest
 ```
 
-### Docker Environment Variables
-
-```env
-# User/Group IDs for file permissions
-PUID=1000
-PGID=1000
-
-# Reddit API credentials (REQUIRED)
-REDDIT_CLIENT_ID=your_client_id
-REDDIT_CLIENT_SECRET=your_client_secret
-REDDIT_USERNAME=your_bot_username
-REDDIT_PASSWORD=your_bot_password
-
-# Application settings
-SOURCE_SUBREDDIT=yoursubreddit
-WIKI_PAGE=modlog
-RETENTION_DAYS=30
-BATCH_SIZE=100
-UPDATE_INTERVAL=300
-ANONYMIZE_MODERATORS=true
+### Docker Compose Example
+
+```yaml
+version: '3.8'
+
+services:
+  redditmodlog-opensignups:
+    image: ghcr.io/bakerboy448/redditmodlog:latest
+    container_name: redditmodlog-opensignups
+    restart: unless-stopped
+    environment:
+      - PUID=1000
+      - PGID=1000
+    volumes:
+      - ./opensignups:/config
+    mem_limit: 256m
+    cpus: 0.5
 ```
 
+### Environment Variables
+
+**User/Group IDs** (for file permissions):
+- `PUID` - User ID (default: 1000)
+- `PGID` - Group ID (default: 1000)
+
+**Reddit API Credentials** (required if not using config file):
+- `REDDIT_CLIENT_ID` - Reddit app client ID
+- `REDDIT_CLIENT_SECRET` - Reddit app client secret
+- `REDDIT_USERNAME` - Bot username
+- `REDDIT_PASSWORD` - Bot password
+- `SOURCE_SUBREDDIT` - Subreddit name
+
+**Optional Settings** (override config.json if set):
+- `WIKI_PAGE` - Wiki page name (default: modlog)
+- `RETENTION_DAYS` - Database retention in days (default: 90, max: 365)
+- `BATCH_SIZE` - Entries per fetch (default: 50, max: 500)
+- `UPDATE_INTERVAL` - Seconds between updates (default: 600, max: 3600)
+- `ANONYMIZE_MODERATORS` - true/false (default: true)
+
+**Internal Paths** (don't modify):
+- `DATABASE_PATH=/config/data/modlog.db`
+- `LOGS_DIR=/config/logs`
+
 ### Docker Image
 
 Pre-built images available at:
 - `ghcr.io/bakerboy448/redditmodlog:latest`
+- `ghcr.io/bakerboy448/redditmodlog:v1.4.x` (specific versions)
 - Multi-architecture: `linux/amd64`, `linux/arm64`
 
+### Docker Features
+
+- ✅ s6-overlay v3 init system for proper process management
+- ✅ PUID/PGID support for file permission management
+- ✅ Automatic config file updates on version upgrades
+- ✅ Single `/config` mount for all persistent data
+- ✅ Supports both config file and environment variable configuration
+- ✅ Built-in troubleshooting tools (htop, vim)
+- ✅ Health checks for monitoring
+
 ## Systemd Service (Production)
 
 ### Installation