+ docker setup

Author: clstaudt

.dockerignore

@@ -0,0 +1,43 @@
+# Git
+.git
+.gitignore
+
+# Python
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+.Python
+env
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Virtual environments
+venv/
+env/
+.venv/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+
+# Docker
+Dockerfile*
+docker-compose*
+
+# Data (if you don't want to include data directory)
+data/
+
+# Pytest
+.pytest_cache/
+.coverage
+htmlcov/ 

Dockerfile

@@ -0,0 +1,29 @@
+FROM python:3.11-slim
+
+# Set working directory
+WORKDIR /app
+
+# Install system dependencies
+RUN apt-get update && apt-get install -y \
+    gcc \
+    g++ \
+    && rm -rf /var/lib/apt/lists/*
+
+# Copy requirements first for better caching
+COPY requirements.txt .
+
+# Install Python dependencies
+RUN pip install --no-cache-dir -r requirements.txt
+
+# Copy application code
+COPY . .
+
+# Expose Streamlit port
+EXPOSE 8501
+
+# Set environment variables
+ENV STREAMLIT_SERVER_PORT=8501
+ENV STREAMLIT_SERVER_ADDRESS=0.0.0.0
+
+# Run the application
+CMD ["streamlit", "run", "app.py", "--server.address=0.0.0.0", "--server.port=8501"] 

README-Docker.md

@@ -0,0 +1,77 @@
+# Docker Setup for Ragnarok PDF Chat
+
+Simple Docker Compose setup for running the Ragnarok PDF Chat application with external Ollama.
+
+## Prerequisites
+
+- Docker & Docker Compose
+- Ollama installed locally
+
+## Quick Start
+
+### 1. Start Ollama with Docker-compatible configuration:
+```bash
+# Important: Ollama must accept connections from Docker containers
+OLLAMA_HOST=0.0.0.0:11434 ollama serve
+```
+
+### 2. Build and run the application:
+```bash
+# Build and start the container
+docker-compose up -d --build
+
+# View logs (optional)
+docker-compose logs -f app
+```
+
+### 3. Access the application:
+- **URL:** http://localhost:8501
+- The app will automatically connect to your local Ollama instance
+- Upload a PDF and start chatting!
+
+## Management Commands
+
+```bash
+# Stop the application
+docker-compose down
+
+# Restart with rebuild
+docker-compose down && docker-compose up -d --build
+
+# View real-time logs
+docker-compose logs -f app
+
+# Check container status
+docker-compose ps
+```
+
+## Requirements
+
+- **Ollama Models:** Download models before using: `ollama pull llama3.2`
+- **PDF Files:** The app processes PDF documents for Q&A
+- **Memory:** Container uses minimal resources (~500MB)
+
+## Troubleshooting
+
+**Connection Issues:**
+```bash
+# 1. Verify Ollama is accessible
+curl http://localhost:11434/api/version
+
+# 2. Check Ollama is configured correctly
+# Must run with: OLLAMA_HOST=0.0.0.0:11434 ollama serve
+
+# 3. Check app logs
+docker-compose logs app
+```
+
+**Common Solutions:**
+- **"No models found"**: Start Ollama with `OLLAMA_HOST=0.0.0.0:11434`
+- **"Can't connect"**: Restart both Ollama and the container
+- **Port 8501 in use**: Change port in docker-compose.yml: `"8502:8501"`
+
+## Notes
+
+- **Data:** Chat history is stored in memory (lost on restart)
+- **Performance:** First model load may take 30+ seconds
+- **Compatibility:** Tested with Ollama 0.7.x and Docker Desktop 

docker-compose.yml

@@ -0,0 +1,18 @@
+version: '3.8'
+
+services:
+  # Streamlit application
+  app:
+    build: .
+    container_name: ragnarok-app
+    ports:
+      - "8501:8501"
+    environment:
+      # Configure Ollama connection (both env vars for compatibility)
+      - OLLAMA_HOST=http://host.docker.internal:11434
+      - OLLAMA_BASE_URL=http://host.docker.internal:11434
+    restart: unless-stopped
+    volumes:
+      - ./data:/app/data  # For persistent data storage
+    extra_hosts:
+      - "host.docker.internal:host-gateway" 

docker.env.example

@@ -0,0 +1,8 @@
+# Ollama Configuration
+# Set the base URL for your Ollama instance
+OLLAMA_BASE_URL=http://localhost:11434
+
+# Examples for different setups:
+# Local Ollama on host: http://host.docker.internal:11434
+# Remote Ollama server: http://your-ollama-server:11434
+# Docker network Ollama: http://ollama-container:11434