> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt. # 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. ```sh 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: ```sh 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. ```sh curl -X POST http://127.0.0.1:5180/api/account/user -H 'Content-Type: application/json' -d '{"email":"you@example.test","password":""}' ``` Next: [the korbo program](/guide/the-korbo-program.md).