Self-Hosted Version - nanomon docs

Introduction

The self-hosted version contains all the key features that our team consider to be needed for a development phase to allow development teams to gain visibility over what are the agents actually doing, what tools are they calling, what is the RAG here and there, what input did this tool got and what outputs did it return.

How to run nanomon locally

To run nanomon locally and start monitoring your agents all you need to do is to:

Copy the docker-compose/yaml example we provide bellow
(optionally) change the environment variables as described bellow

run:

docker-compose -f <docker-compose-file-path> up

The Docker-Compose file

This file defines the three components nanomon needs to properly run. These being the database, the backend api and the frontend (ui). Copy the following file content and place it in a directory of your choice:

version: '3.8'

services:
  # PostgreSQL Database
  postgres:
    image: postgres:16-alpine
    container_name: nanomon_db
    restart: unless-stopped
    environment:
      POSTGRES_USER: ${POSTGRES_USER:-nanomon}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
      POSTGRES_DB: ${POSTGRES_DB:-nanomon}
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER:-nanomon}"]
      interval: 10s
      timeout: 5s
      retries: 5
    networks:
      - nanomon_network

  # API Server
  api:
    image: jlmrodrigues/nanomon_api:latest
    container_name: nanomon_api
    restart: unless-stopped
    depends_on:
      postgres:
        condition: service_healthy
    environment:
      DB_HOST: postgres
      DB_PORT: 5432
      DB_USER: ${POSTGRES_USER:-nanomon}
      DB_PASSWORD: ${POSTGRES_PASSWORD:-changeme}
      DB_NAME: ${POSTGRES_DB:-nanomon}
      DATABASE_URL: postgresql://${POSTGRES_USER:-nanomon}:${POSTGRES_PASSWORD:-changeme}@postgres:5432/${POSTGRES_DB:-nanomon}
      JWT_SECRET: ${JWT_SECRET:-please-change-this-secret-in-production}
      ADMIN_EMAIL: ${ADMIN_EMAIL:-admin@example.com}
      ADMIN_PASSWORD: ${ADMIN_PASSWORD:-changeme123}
      PORT: 8000
    ports:
      - "${API_PORT:-8000}:8000"
    networks:
      - nanomon_network

  # Dashboard (Web UI)
  dashboard:
    image: jlmrodrigues/nanomon_dashboard:latest
    container_name: nanomon_dashboard
    restart: unless-stopped
    depends_on:
      - api
    environment:
      API_URL: ${API_URL:-http://localhost:8000/api/v1}
    ports:
      - "${DASHBOARD_PORT:-80}:80"
    networks:
      - nanomon_network

networks:
  nanomon_network:
    driver: bridge

volumes:
  postgres_data:
    driver: local

Change the default values

The default values in the docker-compose file can be easily changed by copying the .env file contents to an .env file that must be placed in the same directoty as the docker-compose file is

# nanomon Self-Hosted Configuration
# Copy this file to .env and customize your values

# ===========================================
# Admin Account (created on first startup)
# ===========================================
ADMIN_EMAIL=admin@example.com
ADMIN_PASSWORD=changeme123

# ===========================================
# Database Configuration
# ===========================================
POSTGRES_USER=postgres
POSTGRES_PASSWORD=postgres
POSTGRES_DB=nanomon

# ===========================================
# Security (required - change in production!)
# ===========================================
# Generate with: openssl rand -base64 32
JWT_SECRET=please-change-this-secret-in-production

# ===========================================
# Optional: Custom Ports
# ===========================================
# API_PORT=8000
# DASHBOARD_PORT=80

# ===========================================
# Optional: API URL (for production deployments)
# ===========================================
# Set this to your public API URL (browser needs to reach it)
# API_URL=https://api.yourdomain.com/api/v1