Overview
Veritas centralizes day-to-day MSP operations: companies and contacts (PSA), support tickets (ITSM), infrastructure supervision, and RMM. Everything runs on your own infrastructure.
| Component | Path |
|---|
| API & database | veritas/backend |
| Web UI | veritas/frontend |
| Windows RMM agent | veritas/RMM/Agents/windows |
This repository is a monorepo: clone once, then run with Docker or from source.
Screenshots
Helpdesk
Ticket views, filters, and assignment for your support team.
Ticket workspace
Full ticket detail: conversation thread, properties, linked hardware, and resolution workflow.
Supervision center
Infrastructure inventory by site and device type, including servers, storage, network, workstations, and RMM agents.
Administration
Language, timezone, appearance, and organization settings from a single admin area.
Client portal
Dedicated sign-in for end users: equipment, documents, and tickets from their company portal.
Deploy with Docker
git clone https://github.com/veritas-msp/veritas.git
cd veritas
cp .env.docker.example .env
docker compose up -d --build
Then open http://SERVER_IP:3000/setup (secrets and database are configured in the wizard).
| Service | URL |
|---|
| Web UI | http://SERVER_IP:3000 |
| API | http://SERVER_IP:3001 |
Data is stored in Docker volumes veritas-db and veritas-uploads.
If the frontend build runs out of memory on a small VPS, add 2–4 GB of swap, then rebuild:
sudo fallocate -l 4G /swapfile && sudo chmod 600 /swapfile
sudo mkswap /swapfile && sudo swapon /swapfile
docker compose build --no-cache veritas-frontend && docker compose up -d
Development (from source)
Requires Node.js 20+, PostgreSQL 15+, npm, Git.
git clone https://github.com/veritas-msp/veritas.git
cd veritas/veritas
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
npm run install:all
npm run dev
Open http://localhost:3000/setup
| Variable | File | Description |
|---|
JWT_SECRET / ENCRYPTION_KEY | backend/.env | App secrets |
DATABASE_URL | backend/.env | Optional until /setup |
VERITAS_EDITION | backend/.env | community or pro |
REACT_APP_API_BASE_URL | frontend/.env | Default http://localhost:3001 |
REACT_APP_VERITAS_EDITION | frontend/.env | community or pro |
| Service | Port |
|---|
| Frontend | 3000 |
| Backend | 3001 |
| PostgreSQL | 5432 |
Production
Put a reverse proxy (nginx, Traefik, Caddy, …) in front of port 3000 for TLS. Set ALLOWED_ORIGINS and FRONTEND_BASE_URL in .env to your public URL.
Editions
Community and Pro differ in modules and quotas (companies, contacts, agents, RMM endpoints, etc.). Details: EDITIONS.md.
License
GNU Affero General Public License v3.0
