Install Braix (Step-by-step)

From zero to a working Braix Copilot on your own server — then complete the setup wizard.

Before you start

Braix Dashboard + Backend run on your infrastructure. The wizard helps you connect data sources and AI providers.

  • A Linux server (Ubuntu 22.04+ recommended) or Windows Server with WSL2
  • Docker + Docker Compose
  • A domain/subdomain (optional for local testing)

1) Install Docker

On Ubuntu/Debian:

curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
newgrp docker

2) Download Braix Copilot from GitHub

Clone the Basix Foundations monorepo (Braix + theThinx + License Portal + deploy) on your server:

git clone https://github.com/theBasix-AI/basix-core.git
cd basix-core

3) Configure environment

Copy example env files (then edit values like domains, secrets, and provider keys):

cp env.example .env
# open .env and set values

4) Start services

Use Docker Compose to boot the stack.

Linux (recommended)
docker compose up -d --build
Windows + WSL2
wsl
cd /mnt/<drive>/basix-core
docker compose up -d --build

5) Open the wizard and finish setup

After the stack is up, open your Braix URL and follow the Setup wizard. It will guide you through server-id generation, AI provider setup, and connector tests.

Next

Once installed, connect your first data source and run a test question. See the product docs at https://docs.braix.ir/ (requires DNS A record for docs.braix.ir). You can also review available integrations.

See Integrations