QUICK START · ONE COMMAND, UNDER 3 MINUTES

Install Nova AI Agent in under 1 minute.

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

TERMINAL OUTPUT · REAL RUN

nova-agent-install · bash

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

WATCH IT LIVE · UNDER 1 MINUTE

nova install · terminal walkthrough

Click to watch fullscreen

Three steps. One minute. Done.

Generate your install token

30 seconds

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

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

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.

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

Developer CLI · Code Nexus

Also: ship from the terminal.

Once your agent is running, install @nova-ai/cli for a Git-compatible command line that talks to Code Nexus, our enterprise source control. Same flow your team already knows: clone, branch, commit, push, open a PR.

~/projects/nova · nova --help

Nova AI CLI in a terminal showing nova auth login, nova clone, nova add, nova commit, and nova push commands

$npm install -g @nova-ai/cli

Git-compatible

22 commands that mirror Git: nova add, nova commit, nova push, nova rebase. Drop it in, keep your muscle memory.

Code Nexus native

Auth, pull requests, history, blame, and remotes are bound to your Nova workspace, not a third-party Git host.

Agent-aware

Nova agents call nova from CI to file PRs and ship hotfixes. Every command is auditable from the same workspace.

Get a Code Nexus token View command reference