Skip to content
Kryton

Install Kryton with Docker

Kryton ships a docker-compose.prod.yml that brings up a Postgres database and the Kryton server together. This is the fastest path to a running instance.

Prerequisites

Section titled “Prerequisites”

That is it. No Node, no Postgres install — Docker handles both.

Steps

Section titled “Steps”
Terminal window
git clone https://github.com/azrtydxb/kryton.git
cd kryton
cp .env.example .env

Open .env in any editor and set:

  • BETTER_AUTH_SECRET — any random string. Generate one with openssl rand -hex 32.
  • Leave the other defaults alone for now; the compose file wires POSTGRES_URL to the bundled database automatically.

Then:

Terminal window
docker compose -f docker-compose.prod.yml up -d

Open http://localhost:3000 and you should see the login screen.

Kryton login screen 123
  1. First time? Click REGISTER. The first account becomes the admin.
  2. Returning? Email + password, or…
  3. …use a passkey if you set one up earlier.

Register the first user — they automatically get admin role. Done.

What lives where

Section titled “What lives where”
  • ./notes/ — your markdown notes, one folder per user.
  • A Postgres volume (managed by Docker) — accounts, shares, search index.
  • BETTER_AUTH_SECRET in .env — keep this file out of git.

Common tweaks

Section titled “Common tweaks”
  • Port 3000 is taken: edit docker-compose.prod.yml and change the ports: mapping.
  • Stop the stack: docker compose -f docker-compose.prod.yml down.
  • See logs: docker compose -f docker-compose.prod.yml logs -f kryton.

Next steps

Section titled “Next steps”