Quick Start

Install Nova AI Agent in Under 3 Minutes

One command. That is all it takes to connect your infrastructure to 100 AI agents that monitor, detect, and resolve incidents automatically.

nova-agent-install, bash
Nova AI Agent installation terminal showing all green checkmarks for prerequisites, agent install, config creation, service registration, and heartbeat confirmation

Three steps. Three minutes. Done.

1

Generate your install token

30 seconds

Sign up and go to the Instances page in your dashboard. Click "Generate Install Token" to get a short-lived token (valid for 15 minutes).

Sign up at app.novaaiops.com →
2

Run the install command

60 seconds

Copy the install command from your dashboard and paste it into your server terminal. The installer handles everything automatically.

curl -fsSL https://get.novaaiops.com/install.sh | sudo bash -s -- --token YOUR_TOKEN

The installer will:

  • ✓ Check prerequisites (systemd, curl, root access)
  • ✓ Download agent v2.0.0 to /usr/local/bin/nova-ai-agent
  • ✓ Create configuration at /etc/nova/agent.yaml
  • ✓ Register agent and exchange token for secure credentials
  • ✓ Create and start systemd service
  • ✓ Send initial heartbeat to confirm connectivity
3

Verify the agent is running

30 seconds

Check the agent status and view logs to confirm everything is working.

systemctl status nova-ai-agent

You should see "active (running)". View logs with:

journalctl -u nova-ai-agent -f

That is it. Your agent collects 18 system metrics every 15 seconds and sends heartbeats every 30 seconds. 100 AI agents are now monitoring your infrastructure.

18 Metrics Collected Every 15 Seconds

● CPU usage %
● CPU core count
● Memory usage %
● Memory total/used/free
● Disk usage %
● Disk total/used
● Load avg (1m/5m/15m)
● System uptime
● Network RX/TX bytes
● Process count
● Docker containers (running)
● Docker containers (total)

Agent Management Commands

Check status
systemctl status nova-ai-agent
View live logs
journalctl -u nova-ai-agent -f
Restart agent
systemctl restart nova-ai-agent
Upgrade agent
curl -fsSL https://get.novaaiops.com/install.sh | sudo bash -s -- upgrade
File locations
Binary: /usr/local/bin/nova-ai-agent
Config: /etc/nova/agent.yaml
Logs: /var/log/nova/agent.log
Data: /var/lib/nova/
Service: /etc/systemd/system/nova-ai-agent.service

Supported Platforms

  • Linux x86_64 (amd64)
  • Linux ARM64 (aarch64)
  • Linux ARMv7
  • Ubuntu, Debian, CentOS, RHEL
  • Amazon Linux 2 and 2023
  • macOS Intel and Apple Silicon
  • Windows x64
  • Docker containers

Security

  • Install tokens expire in 15 minutes
  • Single-use tokens (marked used after registration)
  • SHA-256 hashed API keys in database
  • API keys auto-rotate every 90 days
  • Outbound HTTPS only (no inbound ports needed)
  • Zero dependencies (uses only Linux system tools)

Requirements

  • 64-bit operating system
  • 256 MB RAM minimum
  • systemd (Linux) or launchd (macOS)
  • curl installed
  • Root or sudo access for install
  • Outbound HTTPS to app.novaaiops.com

Ready to get started?

Create your free account and install the agent in under 3 minutes. No credit card required.

Get Your API Key →