Provide kataba as a Docker image #49

Closed
opened 2026-11-02 19:49:30 +01:00 by miko · 1 comment
Owner

kataba should also be deployable with Docker. Local development stays outside Docker (npm run dev against a local MariaDB).

Scope

  • Multi-stage Dockerfile building a production image from the Next.js standalone output; runs as a non-root user.
  • The container applies pending Prisma migrations (prisma migrate deploy) on start, then starts the server.
  • Uploads live in a volume (UPLOAD_DIR).
  • An example Compose setup with kataba and MariaDB, and an env example for it.
  • .dockerignore.
  • Document Docker deployment in the README; record the decision in an ADR and remove Docker from the "not in v1" lists.

Out of scope

  • Authentik in the Compose setup (it is an external identity provider).
  • Publishing the image to a registry / CI.
kataba should also be deployable with Docker. Local development stays outside Docker (`npm run dev` against a local MariaDB). ## Scope - Multi-stage `Dockerfile` building a production image from the Next.js standalone output; runs as a non-root user. - The container applies pending Prisma migrations (`prisma migrate deploy`) on start, then starts the server. - Uploads live in a volume (`UPLOAD_DIR`). - An example Compose setup with kataba and MariaDB, and an env example for it. - `.dockerignore`. - Document Docker deployment in the README; record the decision in an ADR and remove Docker from the "not in v1" lists. ## Out of scope - Authentik in the Compose setup (it is an external identity provider). - Publishing the image to a registry / CI.
Author
Owner

Implemented in #50: Dockerfile, docker/compose.yaml with MariaDB, migrations on container start, ADR-0014, README section.

Implemented in #50: Dockerfile, docker/compose.yaml with MariaDB, migrations on container start, ADR-0014, README section.
miko closed this issue 2026-11-02 20:03:21 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
MassiveDynamic/kataba#49
No description provided.