Installation | RAGNA Docs

Get the code

git clone https://github.com/ragna-ai/ragna-studio.git
cd ragna-studio
cp .env.example .env

All settings go into .env. Before the first start, set your domains, secrets, storage, one OAuth provider and one AI key. See Configuration and Storage.

Start

make up

make up runs the base compose file plus docker/docker-compose.selfhost.yml. This override sets the in-network hosts for Postgres, Redis and the webbrowser. It overrides the localhost values from .env.example.

The stack starts in order:

Data stores

Postgres and Redis come up.

Migrate

migrate applies the schema.

Seed

seed adds the model catalog and the default agent.

Services

The backend, worker, frontend and webbrowser start.

migrate and seed run once per start and are idempotent.

The frontend and backend listen on 127.0.0.1 only (ports 3000 and 3010). Put a reverse proxy in front of them.

Stop

make down