oma-memorial/DEPLOYMENT.md

OMA Memorial - Deployment Guide

CI/CD Pipeline

Gitea Actions Workflow

Located at .gitea/workflows/deploy.yml

Triggers: Push to main branch

Steps:

1. Checkout code
2. Build Docker image
3. Stop old container
4. Run new container in proxy network
5. Health check
6. Show logs

Docker Setup

Image: Multi-stage build with Node 20 Alpine Container name: oma-memorial Network: proxy (no ports exposed externally) Port: 3000 (internal only)

Requirements

1. Docker Network:

   docker network create proxy
   

2. Data Persistence:

   • Volume mount: ./data:/app/data
   • SQLite database persists across deployments

3. Ollama (optional):

   • Must be running on host or accessible
   • URL: http://localhost:11434 or http://host.docker.internal:11434

Manual Deployment

# Build
docker build -t oma-memorial:latest .

# Run
docker run -d \
  --name oma-memorial \
  --network proxy \
  --restart unless-stopped \
  -e NODE_ENV=production \
  -v $(pwd)/data:/app/data \
  oma-memorial:latest

# Check logs
docker logs -f oma-memorial

# Health check
docker exec oma-memorial curl -f http://localhost:3000

Proxy Integration

The container runs in the proxy network and does not expose ports directly. Use a reverse proxy (nginx, Traefik, Caddy) to route traffic:

Example nginx config:

server {
    listen 80;
    server_name oma.example.com;
    
    location / {
        proxy_pass http://oma-memorial:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

Example Traefik labels:

labels:
  - "traefik.enable=true"
  - "traefik.http.routers.oma.rule=Host(`oma.example.com`)"
  - "traefik.http.services.oma.loadbalancer.server.port=3000"

Environment Variables

• NODE_ENV=production (required)
• PORT=3000 (default)
• ADMIN_PASSWORD (optional, defaults to hash of "Oma2024!")

Troubleshooting

Container won't start:

docker logs oma-memorial

Database issues:

# Check data volume
docker exec oma-memorial ls -la /app/data

Network not found:

docker network create proxy

Build fails:

# Clean build
docker system prune -af
docker build --no-cache -t oma-memorial:latest .