Add new Docker file + instructions

Author: mythz

DOCKER.md

@@ -164,28 +164,37 @@ docker build -t llms-py:latest .
 
 ## Docker Compose
 
-### Start Services
+### Using Pre-built Image (Recommended for Users)
+
+The default `docker-compose.yml` uses the pre-built image from GitHub Container Registry:
 
 ```bash
+# Start services
 docker-compose up -d
-```
-
-### View Logs
 
-```bash
+# View logs
 docker-compose logs -f
-```
-
-### Stop Services
 
-```bash
+# Stop services
 docker-compose down
 ```
 
-### Rebuild and Restart
+### Building from Source (For Developers)
+
+If you've cloned the repository and want to build from source, use `docker-compose.local.yml`:
 
 ```bash
-docker-compose up -d --build
+# Build and start services
+docker-compose -f docker-compose.local.yml up -d --build
+
+# View logs
+docker-compose -f docker-compose.local.yml logs -f
+
+# Stop services
+docker-compose -f docker-compose.local.yml down
+
+# Rebuild and restart
+docker-compose -f docker-compose.local.yml up -d --build
 ```
 
 ## Data Persistence

README.md

@@ -80,10 +80,7 @@ Run llms-py in a Docker container without installing Python or dependencies:
 docker pull ghcr.io/servicestack/llms:latest
 
 # Run the server on port 8000
-docker run -p 8000:8000 \
-  -e OPENROUTER_API_KEY=$OPENROUTER_API_KEY \
-  -e GROQ_API_KEY=$GROQ_API_KEY \
-  ghcr.io/servicestack/llms:latest
+docker run -p 8000:8000 -e OPENROUTER_API_KEY=$OPENROUTER_API_KEY ghcr.io/servicestack/llms:latest
 ```
 
 Or use docker-compose (recommended):
@@ -95,6 +92,7 @@ docker-compose up
 **Using docker-compose** (recommended for local development):
 
 1. Create a `.env` file with your API keys:
+
 ```bash
 OPENROUTER_API_KEY=your-key
 GROQ_API_KEY=your-key

docker-compose.local.yml

@@ -0,0 +1,49 @@
+version: '3.8'
+
+services:
+  llms:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: llms-py:latest
+    container_name: llms-py
+    ports:
+      - "8000:8000"
+    environment:
+      # API Keys - Set these in your .env file or pass them directly
+      - OPENROUTER_API_KEY=${OPENROUTER_API_KEY:-}
+      - GROQ_API_KEY=${GROQ_API_KEY:-}
+      - GOOGLE_FREE_API_KEY=${GOOGLE_FREE_API_KEY:-}
+      - GOOGLE_API_KEY=${GOOGLE_API_KEY:-}
+      - CODESTRAL_API_KEY=${CODESTRAL_API_KEY:-}
+      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY:-}
+      - OPENAI_API_KEY=${OPENAI_API_KEY:-}
+      - GROK_API_KEY=${GROK_API_KEY:-}
+      - DASHSCOPE_API_KEY=${DASHSCOPE_API_KEY:-}
+      - ZAI_API_KEY=${ZAI_API_KEY:-}
+      - MISTRAL_API_KEY=${MISTRAL_API_KEY:-}
+    volumes:
+      # Persist configuration and analytics data
+      # The container will auto-create llms.json and ui.json on first run
+      - llms-data:/home/llms/.llms
+
+      # Alternative: Mount a local directory to use custom config files
+      # Uncomment the line below and comment out the line above to use local configs
+      # Place your custom llms.json and ui.json in ./config/ directory
+      # - ./config:/home/llms/.llms
+
+      # Alternative: Mount individual config files (read-only recommended)
+      # - ./my-llms.json:/home/llms/.llms/llms.json:ro
+      # - ./my-ui.json:/home/llms/.llms/ui.json:ro
+    restart: unless-stopped
+    healthcheck:
+      test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000').read()"]
+      interval: 30s
+      timeout: 10s
+      retries: 3
+      start_period: 5s
+
+volumes:
+  llms-data:
+    driver: local
+

docker-compose.yml

@@ -2,11 +2,8 @@ version: '3.8'
 
 services:
   llms:
-    build:
-      context: .
-      dockerfile: Dockerfile
-    image: llms-py:latest
-    container_name: llms-server
+    image: ghcr.io/servicestack/llms:latest
+    container_name: llms-py
     ports:
       - "8000:8000"
     environment:
@@ -23,27 +20,13 @@ services:
       - ZAI_API_KEY=${ZAI_API_KEY:-}
       - MISTRAL_API_KEY=${MISTRAL_API_KEY:-}
     volumes:
-      # Persist configuration and analytics data
-      # The container will auto-create llms.json and ui.json on first run
-      - llms-data:/home/llms/.llms
-
-      # Alternative: Mount a local directory to use custom config files
-      # Uncomment the line below and comment out the line above to use local configs
-      # Place your custom llms.json and ui.json in ./config/ directory
-      # - ./config:/home/llms/.llms
-
-      # Alternative: Mount individual config files (read-only recommended)
-      # - ./my-llms.json:/home/llms/.llms/llms.json:ro
-      # - ./my-ui.json:/home/llms/.llms/ui.json:ro
+      # Maintain user-modifiable config files outside the container
+      # llms.json and ui.json will be auto-created on first run
+      - ~/.llms:/home/llms/.llms
     restart: unless-stopped
     healthcheck:
       test: ["CMD", "python", "-c", "import urllib.request; urllib.request.urlopen('http://localhost:8000').read()"]
       interval: 30s
       timeout: 10s
       retries: 3
       start_period: 5s
-
-volumes:
-  llms-data:
-    driver: local
-