scholarr/docs/user/getting-started.md

User Getting Started

Required Setup

1. Copy .env.example to .env.
2. Set POSTGRES_PASSWORD.
3. Set SESSION_SECRET_KEY.

Deploy Method A: Prebuilt Image

docker compose pull
docker compose up -d

Open:

• App/API: http://localhost:8000
• Health endpoint: http://localhost:8000/healthz

Upgrade:

docker compose pull
docker compose up -d

Deploy Method B: Local Source + Dev Frontend

docker compose -f docker-compose.yml -f docker-compose.dev.yml up -d --build

Open:

• API: http://localhost:8000
• Frontend dev server: http://localhost:5173

Stop:

docker compose -f docker-compose.yml -f docker-compose.dev.yml down