/ Deployment

Deployment Options

Run Unimatrix as a managed cloud service, or self-host the entire stack on your own infrastructure. Same codebase, two paths.

Cloud vs. self-hosted, at a glance

	Managed Cloud	Self-Hosted
Setup time	Minutes — sign up and generate an API key	Hours — provision Postgres, run migrations, configure env vars
Infrastructure ownership	Fully managed by Unimatrix	You own the servers, database, and uptime
Updates & patches	Automatic	You pull and redeploy new releases yourself
Data residency	Unimatrix-managed Postgres + pgvector	Stays entirely on your own infrastructure
Compliance / air-gapped use	Limited — shared managed environment	Full control — suitable for regulated or offline environments
Cost model	Free / Pro / Enterprise subscription	Enterprise plan + your own infra costs
Best for	Individuals and teams who want zero ops	Teams with compliance needs or an existing ops function

Self-hosting requires the Enterprise plan. See pricing for details.

Docker and Docker Compose (or equivalent container orchestration)
A PostgreSQL instance with the pgvector extension enabled
Someone on your team to own updates, backups, and database maintenance
Environment variables for encryption keys, auth secrets, and database connection strings — see the full list in the repo's setup guide

git clone https://github.com/tjpoisal/UNIMATRIX.git
cd UNIMATRIX
cat DOCKER_SETUP.md

2
Provision Postgres with pgvector
Enable the extension once on your database, then run the raw SQL migrations before Prisma migrations:
```
CREATE EXTENSION IF NOT EXISTS vector;
```
3
Configure environment variables
Set database URLs, encryption keys, and auth secrets consistently across every service. Full variable list is documented in the repo.

docker compose -f docker-compose.prod.yml up -d

The complete, up-to-date self-hosting instructions — including every required environment variable — live in DOCKER_SETUP.md in the repo.

Questions about self-hosting for your team? Email hello@deployunimatrix.com