Self-host setup guide

Jemah is a self-hosted research workspace. This page summarizes the operator path on a fresh clone; the full checklist lives in docs/SETUP_AND_GAPS.md on the server.

1. Base environment

Copy .env.example to .env and set Postgres, Weblate, and LLM keys.
Bootstrap: ./scripts/bootstrap-env.sh --live-tm or ./scripts/setup-all.sh --ml --portal --live-tm.
Confirm health: Weblate /healthz/, suggester :8001/health, embedder :8002/health.

2. Writer UI + API

Production uses one public hostname for the Next.js shell and FastAPI backend (for example jemah.ennak.net). Set NEXT_PUBLIC_WRITER_URL to that origin before building writer-web.

3. Sign-in and access

Library, notes, and operations require a signed-in account (or operator token for pipeline views). Edge HTTP basic auth is optional; app-layer WRITER_AUTH_REQUIRED still protects API routes.

Back to home

Jemah is a self-hosted research workspace. This page summarizes the operator path on a fresh clone; the full checklist lives in docs/SETUP_AND_GAPS.md on the server.

1. Base environment

Copy .env.example to .env and set Postgres, Weblate, and LLM keys.
Bootstrap: ./scripts/bootstrap-env.sh --live-tm or ./scripts/setup-all.sh --ml --portal --live-tm.
Confirm health: Weblate /healthz/, suggester :8001/health, embedder :8002/health.

2. Writer UI + API

Production uses one public hostname for the Next.js shell and FastAPI backend (for example jemah.ennak.net). Set NEXT_PUBLIC_WRITER_URL to that origin before building writer-web.

3. Sign-in and access

Library, notes, and operations require a signed-in account (or operator token for pipeline views). Edge HTTP basic auth is optional; app-layer WRITER_AUTH_REQUIRED still protects API routes.

Back to home