# BookWyrm + Caddy: Static Files Fix

**Caddy is proxying directly to Gunicorn**, which doesn't serve static files. It returns HTML for every `/static/` request, and the browser blocks it due to MIME type mismatch.

The fix is to add a small nginx container between Caddy and Gunicorn. nginx serves `/static/` and `/images/` straight from the Docker volumes, and passes everything else to Gunicorn.

## 1. Add the nginx config

Create nginx-books/nginx.conf next to your docker-compose.yml]:

```nginx
upstream bookwyrm {
    server bookwyrm-web:8000;
}

server {
    listen 80;
    client_max_body_size 10M;

    location /static/ {
        alias /app/static/;
    }

    location /images/ {
        alias /app/images/;
    }

    location / {
        proxy_pass http://bookwyrm;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header Host $host;
        proxy_set_header X-Forwarded-Proto https;
        proxy_redirect off;
    }
}
```

## 2. Add the nginx service to docker-compose.yml

```yaml
bookwyrm-nginx:
  image: nginx:alpine
  restart: unless-stopped
  depends_on:
    - bookwyrm-web
  volumes:
    - ./nginx-books/nginx.conf:/etc/nginx/conf.d/default.conf:ro
    - bookwyrm_static:/app/static:ro
    - bookwyrm_media:/app/images:ro
```

Make sure it's on the same Docker network as your other BookWyrm containers.

## 3. Update Caddy to point at nginx, not Gunicorn

```
books.yourdomain.com {
  reverse_proxy bookwyrm-nginx:80
}
```

Instead of `bookwyrm-web:8000`.

## 4. Restart everything

```bash
docker compose up -d
```

If Caddy seems to be ignoring the new config, `caddy reload` doesn't always apply changes. Do a full restart instead:

```bash
docker compose up -d --force-recreate caddy
```

## One gotcha: celery-beat needs EMAIL_HOST

BookWyrm's settings require `EMAIL_HOST` even for containers that never send email (like `celery-beat`). Pass the full email env block to all BookWyrm containers or beat will crash on startup.