Prerequisites
Before setting up Proxima Console locally, make sure you have the following software installed.
Required Software
| Tool | Version | Purpose |
|---|---|---|
| Go | 1.24+ | Builds and runs the agent and backend |
| Node.js | 20+ | Builds and runs the frontend (React/TypeScript) |
| Docker | Latest | Runs PostgreSQL, NATS, Tempo, and other services as containers |
| Docker Compose | v2+ | Orchestrates the local development infrastructure |
| golangci-lint | Latest | Go linter, used by make lint and pre-commit hooks |
| golang-migrate CLI | Latest | Applies database migrations (make migrate-up) |
| PostgreSQL client (psql) | 16+ | Used by seed scripts to populate development data |
Installation Guides
Go
Install Go 1.24 or later from go.dev/dl. Verify with:
go version
Node.js
Install Node.js 20 or later using nvm (recommended) or from nodejs.org:
nvm install 20
node --version
npm --version
Docker and Docker Compose
Install Docker Desktop (includes Compose v2) from docker.com. Verify with:
docker --version
docker compose version
golangci-lint
Install using the official script or a package manager:
# Binary install (recommended)
curl -sSfL https://raw.githubusercontent.com/golangci/golangci-lint/master/install.sh | sh -s -- -b $(go env GOPATH)/bin
# Verify
golangci-lint --version
golang-migrate CLI
Install from github.com/golang-migrate/migrate:
# macOS
brew install golang-migrate
# Linux (binary)
curl -L https://github.com/golang-migrate/migrate/releases/download/v4.17.0/migrate.linux-amd64.tar.gz | tar xvz
sudo mv migrate /usr/local/bin/
# Verify
migrate --version
PostgreSQL Client (psql)
The psql client is needed for seed scripts. Install it without the full server:
# macOS
brew install libpq && brew link --force libpq
# Ubuntu/Debian
sudo apt-get install postgresql-client
# Verify
psql --version
Verify Everything
Run the following to confirm all tools are available:
go version # Go 1.24+
node --version # v20+
docker --version # Docker 24+
docker compose version # v2+
golangci-lint --version
migrate --version
psql --version
Once all prerequisites are installed, proceed to the Quick Start guide.