Getting Started
Get NOBA running and monitoring your infrastructure in under 5 minutes.
Prerequisites
- Linux (Fedora, Ubuntu, Debian, Raspberry Pi OS, TrueNAS SCALE)
- Python 3.10+
- Network access to the systems you want to monitor
Quick Install
curl -fsSL https://www.nobacmd.com/install.sh | bash
Grab your generated admin password:
journalctl --user -u noba-web.service | grep password
Open http://your-host:8080 in your browser and log in.
Docker
NOBA is distributed as a signed, SHA-verified image tarball on R2 instead of a public registry (single supply-chain surface, no third-party dependency). The install script curls the latest version tarball, verifies its SHA-256, loads it into the local Docker daemon, and tags it as noba-enterprise:latest so docker run and docker compose work immediately:
curl -fL https://www.nobacmd.com/download/latest/docker-install.sh | bash
docker compose up -d
Run on any host with Docker installed. No registry login required; no rate limits. To pin a specific version, prefix with NOBA_VERSION=:
curl -fL https://www.nobacmd.com/download/latest/docker-install.sh | NOBA_VERSION=2.1.0-beta.35 bash
Connect your first integration
- Navigate to Settings > Integrations
- Select an integration (Proxmox VE, Docker, Pi-hole, etc.)
- Enter connection details and test the connection
- NOBA begins collecting telemetry immediately
Deploy remote agents
For remote sites, deploy a lightweight agent on any Linux or Windows host. 42+ command types across 3 risk tiers, remote desktop, embedded terminal, and file transfer. The Linux agent is a Python script (zero dependencies beyond a system Python 3); the Windows agent is a pre-built static Rust binary published on every release — no Python, no .NET runtime, no build-from-source step.
One-click deploy
From the dashboard, use Agents > Deploy to push the agent over SSH (Linux) or copy-paste a PowerShell bootstrap (Windows).
Linux — script deploy
curl -sf "http://noba-server:8080/api/agent/install-script?key=YOUR_KEY" | sudo bash
Windows — PowerShell bootstrap (Administrator)
From the dashboard: Agents > Deploy Agent > Windows generates a ready-to-paste bootstrap that downloads the Rust noba-agent.exe from the NOBA server and registers it as a Windows service. Or fetch it directly:
iwr "http://noba-server:8080/api/agent/install-script?type=rust&platform=windows&key=YOUR_KEY" `
-UseBasicParsing | Select-Object -ExpandProperty Content | iex
Requirements: Windows 10 / 11 or Server 2019+, Administrator elevation (the agent registers with the Service Control Manager and writes C:\ProgramData\noba-agent\config.json on first install).
Agents connect over encrypted WebSocket with HTTP polling fallback. No VPN or port forwarding required. They self-update when the server has a newer version.