Skip to main content
← Back to Unimatrix

Deployment Architecture

The hosted service is a single host we operate. Self-hosting and a separate deployment are discussed under an enterprise agreement. An air-gapped build is not a self-serve option.

Deployment Comparison

 Managed CloudSelf-Hosted DockerDedicated Private VPC
Setup timeRegister and create an API keyYou provision Docker and PostgreSQL with pgvectorDiscussed under contract
Infrastructure controlWe operate the current single hostYou run the machinesA separate deployment discussed under contract
Updates & operationsWe install updates during a maintenance window we will tell you aboutYou apply updates and migrationsOperations are whatever the contract says
Data residencyPostgreSQL on the host we operateData stays on machines you run, except for services you choose to configureResidency is whatever the contract says
SecurityRow-level security on the shared database, for every planYou control the network and the keys on your machinesTerms are the contract you and we sign. Unimatrix is not SOC 2, HIPAA, ISO 27001, or FedRAMP certified.
Plan levelFree / Pro / BusinessEnterprise plan (starting at $1,500/mo)Enterprise, by agreement

Self-hosting and Private VPC options require an Enterprise plan. See pricing for details.

What self-hosting requires

  • Docker and Docker Compose (or equivalent container orchestration)
  • PostgreSQL with pgvector. The current development and production target is PostgreSQL 16.
  • 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

Self-hosting in outline

  1. 1

    Get the repository after an agreement

    After your agreement is in place, we provide the repository or image pull instructions. Do not use a public clone URL. The public GitHub URL is not a clone target.

  2. 2

    Provision Postgres with pgvector

    The Compose Postgres service enables pgvector. Schema install is pnpm --filter web db:migrate:deploy: the identity helper, Prisma migrations, then the server SQL migrations. Do not run prisma db push in place of that command.

    CREATE EXTENSION IF NOT EXISTS vector;
  3. 3

    Configure environment variables

    Set database URLs, encryption keys, and auth secrets consistently across every service. Full variable list is documented in the repo.

  4. 4

    Bring the stack up with Docker Compose

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

Setup instructions

Environment variables and compose files are delivered with the licensed source or images. Email hello@deployunimatrix.com to ask about an enterprise agreement.

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