Skip to content

Add comprehensive Docker installation guide for system administrators#1

Open
xezpeleta wants to merge 2 commits into
Lamb-Project:mainfrom
xezpeleta:docs/sysadmin-docker-guide
Open

Add comprehensive Docker installation guide for system administrators#1
xezpeleta wants to merge 2 commits into
Lamb-Project:mainfrom
xezpeleta:docs/sysadmin-docker-guide

Conversation

@xezpeleta

Copy link
Copy Markdown
Collaborator

Overview

This PR adds a comprehensive installation and configuration guide for system administrators who want to deploy LAMB using Docker in production environments.

Changes

New Documentation Files

  • content/en/sysadmins.md - English version
  • content/es/sysadmins.md - Spanish version
  • content/ca/sysadmins.md - Catalan version
  • content/eu/sysadmins.md - Basque version

Content Includes

1. Environment Variables Configuration

  • Complete .env file template with all required and optional variables
  • Detailed explanation of each configuration section
  • Default values and security recommendations

2. Docker Compose Setup

  • Full docker-compose.yml configuration
  • Service definitions for lamb, kb, openwebui, and ollama
  • Volume and network configuration
  • Health checks and dependencies

3. Service Deployment

  • Step-by-step deployment instructions
  • Verification commands
  • Access credentials and security notes

4. Production Optimization

4.1. Reverse Proxy Configuration
  • Complete Caddy setup with Docker Compose integration
  • Full Caddyfile configuration with route explanations
  • Automatic SSL/TLS certificate management via Let's Encrypt
  • Separate configuration approach using docker-compose.prod.yml
4.2. Workers Configuration
  • Detailed explanation of Uvicorn workers
  • Configuration via LAMB_WORKERS environment variable
  • Recommendations table for different environments and loads
  • Worker calculation formula: Workers = (2 × CPU Cores) + 1
  • Verification steps and additional considerations

Benefits

  • Professional documentation: Technical and precise language appropriate for sysadmins
  • Complete guide: Covers from basic installation to production optimization
  • Multilingual: Available in 4 languages (EN, ES, CA, EU)
  • Best practices: Includes security recommendations and performance tuning
  • Production-ready: Real-world configuration examples

Dependencies

Note: The workers configuration section documents the LAMB_WORKERS environment variable feature introduced in Lamb-Project/lamb#362. This documentation will be fully applicable once that PR is merged.

xezpeleta added 2 commits May 7, 2026 15:43
- Add detailed Docker installation and configuration guide
- Include environment variables configuration with .env file
- Document Docker Compose setup with all required services
- Add reverse proxy configuration with Caddy
- Document workers configuration via LAMB_WORKERS environment variable
- Add verification and troubleshooting steps
- Include production optimization best practices
- Translate guide to all available languages (en, es, ca, eu)
- Remove detailed Caddyfile configuration explanation
- Remove worker calculation formula section
- Remove additional considerations section
- Align all translations (en, ca, eu) with the updated Spanish version
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant