Skip to main content
This walkthrough assumes you already have at least one Lager box reachable over the network (whether on your LAN, a VPN, or Tailscale). If you don’t yet, start with the Lager getting-started docs and come back when you have lager hello working.

​
1. Create your account

Go to app.stoutdata.ai and sign up with your work email. You’ll receive a verification link — click it, then sign in. On first login Stout creates a personal organization for you. You can rename it and invite teammates from Settings. Additional organizations are provisioned by a Stout admin — reach out if your team needs a second org.

​
2. Register your first box

From the dashboard, open Boxes → Add Box. Give it a name and enter its IP address. Stout will:
  1. Generate a one-time setup command you paste onto the box over SSH.
  2. Exchange an API key with the box so it can send heartbeats to the control plane.
  3. Pull the Stout agent container (ghcr.io/stoutdata/stout:latest) onto the box.
Once the heartbeat reaches the control plane, the box shows as online in the fleet view. Opening the box detail page reveals the Overview, Nets, Webcams, and Settings tabs.
The install flow writes to /etc/lager/ on the box. Both /etc/lager and /etc/lager/authorized_keys.d/ must be mode 777 so the control plane’s SSH key sync works. See the Boxes reference for details.

​
3. Run your first job

The Jobs dashboard UI is coming soon — the API described below is already live, so you can submit jobs programmatically today while the UI is being finished.
From Jobs → New Job, pick your box, paste a Python script, and click Run. A reasonable hello-world: 
from lager import Net, NetType

supply = Net.get("supply1", type=NetType.PowerSupply)
print("Voltage:", supply.voltage())
Stout uploads the script to the box’s Python service on port 5000, streams stdout/stderr back over server-sent events, and captures any artifacts. The job detail page shows the live log, the final status, and download links for artifacts.

​
4. What’s next

Invite teammates

Add members, create teams, and control which boxes each person can run jobs on.

Chain jobs into workflows

Multi-step, event-triggered automation with a visual dependency graph. (Coming soon.)

Connect GitHub

Auto-run tests on pull requests against your real hardware.

Set up SSO

Sign your team in through OIDC or SAML.