Skip to main content

Getting Started

Get Nibchat running locally in under 5 minutes.

Prerequisites​

  • Docker and Docker Compose
  • An API key from an OpenAI-compatible provider (OpenAI, Anthropic via proxy, etc.)

1. Clone the repository​

git clone https://github.com/nibchat-ai/nibchat.git
cd nibchat

2. Configure environment variables​

cp server/.env.example server/.env

Open server/.env and set at minimum:

OPENAI_API_KEY=sk-...

3. Start the app​

docker compose up -d

Nibchat is now running at http://localhost:3000.

4. Create your admin account​

On first run, no admin account exists. The bootstrap token is printed in the server logs:

docker compose logs server

Look for:

========================================
  No admin account found.
  Visit /admin/setup to create one.
  Bootstrap token: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
========================================

Navigate to http://localhost:3000/admin/setup, enter the token, and create your admin credentials.

Password requirements

Passwords must be at least 8 characters and include uppercase, lowercase, a number, and a special character.

Next steps​