Getting started

This guide takes you from nothing to your first server on the dashboard. If you can paste a command into a terminal, you can do this.

What you’ll set up

  • The control plane — the dashboard that collects reports. We host one for you on managed plans, or you deploy your own on-prem on Enterprise.
  • The agent — a tiny program you put on each server you want to watch.

1. Get your dashboard

Pick a plan on the pricing page or contact sales. We provision your hosted dashboard and give you two things:

  • your dashboard URL, e.g. https://monitor.example.com, and
  • an enrollment token — agents use it to prove they’re allowed to report.

On the Enterprise plan you can instead run the control plane on-prem — see Control plane.

2. Download the agent

Grab the signed agent binary for your platform from your dashboard’s downloads page (Linux, Windows, or macOS — one binary per platform).

3. Run the agent

On any server you want to watch, point the agent at your dashboard with your token:

./lookout-agent run --server https://monitor.example.com --token your-enrollment-token --once

Refresh the dashboard — your server is there, with its status, memory, disk, and services.

4. Keep it reporting

Drop --once to have the agent report continuously (every minute by default):

./lookout-agent run --server https://monitor.example.com --token your-enrollment-token

In production you’d install the agent as a service so it starts on boot — see Install the agent.

Just want to look first?

You can also collect a report without a server, to see exactly what the agent gathers:

./lookout-agent report

Next steps