For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /guide/run-the-hub.md.

Run the hub

These steps run the hub on your own machine, at http://127.0.0.1:5180.

Requirements

  • The .NET SDK named in the repository's global.json (11.0.100).
  • Docker, for the database.
  • A checkout of katadofu where src/Korbo.Api/Korbo.Api.csproj expects it: ..\..\..\..\_dev\IdeaProjects\katadofu, seen from src/Korbo.Api.

1. Start the database

The container listens on 127.0.0.1:5433 only.

docker run -d --name korbo-postgres -e POSTGRES_PASSWORD=korbo-dev -e POSTGRES_DB=korbo -p 127.0.0.1:5433:5432 postgres:17

After a restart of the machine, start it again with docker start korbo-postgres.

The password korbo-dev is for this local database only. Do not use it for a database another machine can reach.

2. Start the hub

In Development the hub brings its database up to date when it starts. From the repository root, in Git Bash:

ASPNETCORE_ENVIRONMENT=Development ASPNETCORE_URLS=http://127.0.0.1:5180 ConnectionStrings__korbo="Host=127.0.0.1;Port=5433;Database=korbo;Username=postgres;Password=korbo-dev" dotnet run --project src/Korbo.Api

On its first start the hub creates two key files for its tokens in local/keys/. If they are deleted or replaced, every program has to sign in again.

3. Create your account

There is no sign-up page yet, so send the request yourself. The password must not contain the email address.

curl -X POST http://127.0.0.1:5180/api/account/user -H 'Content-Type: application/json' -d '{"email":"you@example.test","password":"<a long password>"}'

Next: the korbo program.