← Back to docs

Getting started

Run the Python core locally, bootstrap an admin, and connect the Next.js console.

Prerequisites

  • Python 3.11+, Node.js 20+, and pnpm 9+.
  • Optional provider credentials for Coolify, Mailcow, and Cloudflare.

Backend

  • Copy `.env.example` to `.env` and set `APP_SECRET`.
  • Install dependencies with `uv sync --extra dev`.
  • Start the API with `uv run uvicorn app.main:app --reload --port 8088`.
  • Bootstrap an admin with `scripts/bootstrap-admin.sh`.

Frontend

  • From the repo root run `pnpm install`.
  • Start the console with `pnpm --filter web dev`.
  • Sign in at `/auth/login` using your admin credentials.