Run Vifu with Docker

Docker is the shortest path to a complete Vifu deployment.

First start

From the Vifu repository root:

cp .env.example .env
docker compose up -d

Open http://localhost:6791 and create the first local administrator. Confirm the runtime independently of the Dashboard:

curl --fail --silent http://127.0.0.1:6790/health

The Dashboard then guides you through project, provider, and Agent setup.

Start it again

The next time you use the same checkout and data volume:

docker compose up -d

To stop the services while keeping project data:

docker compose down

Rebuild after source changes

docker compose up -d --build

PostgreSQL data lives in the postgres_data volume, so normal restarts and container replacement preserve the deployment. Do not run docker compose down --volumes unless you intend to delete its data.

Vifu Server applies database migrations before accepting traffic. Back up PostgreSQL before upgrading across releases.

Next step

Open Agent Providers to connect an Agent runtime or model. Read Self-hosting Vifu before making the Dashboard or runtime reachable outside the local machine.