running-and-testing-locally
Installation
SKILL.md
Running and Testing Nango Locally
Overview
Nango runs as a set of microservices (server, webapp, jobs, persist, orchestrator, metering, connect-ui) backed by Docker containers (PostgreSQL, Redis, Elasticsearch, ActiveMQ). Two terminal sessions are needed: one for TypeScript watch-build, one for running services.
Quick Reference
| Command | Purpose | When to use |
|---|---|---|
npm run dev:docker |
Start Docker deps (DB, Redis, ES, ActiveMQ) | First step, once per session |
npm run dev:watch (alias dw) |
TypeScript watch-build | Terminal 1 — always running |
npm run dev:watch:apps (alias dwa) |
Run all services | Terminal 2 — full stack |
npm run dev:watch:web |
Run server + webapp + connect-ui only | Terminal 2 — frontend work |
npm run dev:watch:headless (alias dwh) |
Run backend services only (no UI) | Terminal 2 — backend work |