Run OTAS locally without Docker

You can run OTAS entirely on your local machine with Python 3.10+, Node.js 18+, PostgreSQL 16, and Redis 7 installed directly — or use Docker Compose for a one-command setup that manages all dependencies automatically. Both approaches produce the same running system; choose whichever fits your workflow.

Prerequisites

Docker Compose (recommended)
Manual

Install Docker Desktop or Docker Engine with the Compose plugin. No other runtime dependencies are required — Docker pulls PostgreSQL, Redis, and Python images automatically.See Deploy OTAS with Docker Compose for the full walkthrough.

Install the following on your host machine before proceeding:

Dependency	Minimum version
Python	3.10
Node.js	18
PostgreSQL	16
Redis	7

You will also need two separate PostgreSQL databases — one for UASAM and one for Brain — and two Redis instances (or two separate databases on one instance).

Manual setup

Start UASAM

UASAM handles all user authentication, project management, and agent key issuance.

cd backend/uasam
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Create an env file at backend/uasam/env/env-local.env (or export the variables directly) with your PostgreSQL and Redis credentials, then run migrations and start the server:

python manage.py migrate
python manage.py runserver 0.0.0.0:8000

UASAM is now listening on http://localhost:8000.

Start Brain

Brain captures events from your SDK and agents and serves all analytics data.

cd backend/brain
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Create backend/brain/env/env-local.env with credentials for Brain’s own PostgreSQL database (port 5433) and Redis (port 6378), then migrate and start:

python manage.py migrate
python manage.py runserver 0.0.0.0:8002

Brain is now listening on http://localhost:8002. If you need async Celery processing, start the worker and beat in separate terminals:

celery -A brain worker --loglevel=info
celery -A brain beat --loglevel=info

Start the frontend

The React dashboard connects to UASAM and Brain using the URLs defined in src/constants.ts.

cd frontend/otas-frontend
npm install
npm run dev

The Vite dev server starts on http://localhost:5173.

Port reference

Service	Default port
UASAM (Django)	8000
Brain (Django)	8002
Frontend (Vite)	5173
UASAM PostgreSQL	5432
Brain PostgreSQL	5433
UASAM Redis	6379
Brain Redis	6378

If any of your services run on a non-default host or port, update UASAM_ENDPOINT and BRAIN_ENDPOINT in frontend/otas-frontend/src/constants.ts and restart the Vite dev server. See Configure OTAS frontend endpoints for details.

Get Started

Core Concepts

Agent Integration

Analytics & Dashboard

Deployment

Run OTAS locally without Docker

Prerequisites

Manual setup

Port reference

​Prerequisites

​Manual setup

​Port reference

Prerequisites

Manual setup

Port reference