# Pixelfed — Notes

## mattlqx/docker-pixelfed: APP_PORT required

The `ghcr.io/mattlqx/docker-pixelfed` community image generates its nginx config from env vars
using `sed`. The `listen` directive uses `${APP_PORT}`, which must be set explicitly — without it,
nginx crashes with `invalid number of arguments in 'listen' directive`.

```yaml
env:
  - name: APP_PORT
    value: "80"
```

The image listens on port 80 (nginx), not 8080 as the original pixelfed image did.

## Shared storage PVC requires ReadWriteMany

Both the web and worker deployments must mount the shared storage PVC simultaneously. Use
`ReadWriteMany` access mode — `ReadWriteOnce` with two pods causes multi-attach errors.
(`RollingUpdate` + RWO also triggers this; use `Recreate` strategy or RWX.)