Files
wild-directory/bookwyrm/notes.md
Paul Payne 4d983819c9 feat(supabase): add services and statefulset for database management
feat(synapse): update ingress to use traefik ingress class and bump version

feat(syncthing-discovery): introduce syncthing discovery service with deployment and ingress

feat(syncthing-relay): add syncthing relay server with deployment and ingress configuration

fix(taiga): update liveness and readiness probes to use tcpSocket for health checks

fix(taiga): change PVC access mode to ReadWriteMany for media and static storage

feat(traefik): add icon and ignore rules for traefik service

docs(ushahidi): add notes for Redis configuration and Laravel startup probe adjustments

feat(ushahidi): implement dedicated Redis deployment for Ushahidi

fix(vllm): update deployment strategy and readiness/liveness probes for improved stability

fix(writefreely): pin writefreely image version to v0.15.1 for consistency

docs(zulip): add notes for TLS-terminating reverse proxy configuration and expected behavior
2026-07-02 21:34:27 +00:00

1.3 KiB

BookWyrm — Notes

SCSS themes must be compiled before collectstatic

BookWyrm ships SCSS source files instead of pre-compiled CSS. The static root is an emptyDir (ephemeral), so it is empty on every pod restart. Running collectstatic alone fails:

ValueError: Missing staticfiles manifest entry for 'css/themes/...'

Fix: compile themes before collecting static files:

command: ["/bin/sh", "-c"]
args:
  - |
    python manage.py compile_themes \
    && python manage.py collectstatic --noinput \
    && python manage.py migrate \
    && exec gunicorn bookwyrm.wsgi:application ...

Check the image's Dockerfile or docker_start.sh to confirm the current required build steps.

PostgreSQL extensions require superuser

BookWyrm uses extensions (bloom, pg_trgm, etc.) that require superuser to install. Migrations fail with permission denied to create extension "bloom" if the app DB user is not a superuser.

Fix: create the extensions in the db-init-job, which connects as the postgres superuser:

psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS bloom;"
psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"

This must run before migrations (i.e. in db-init-job, not in the app startup command).