Skip to main content
This guide helps you set up Insaion, invite your team, and connect your first device. If you only need the device agent steps, see the Insaion Agent guide.

​
1) Create your account

  1. Go to https://app.insaion.com and create an account.
  2. Name your organization and workspace.

​
2) Add your first device

  1. Go to Devices → Add Device.
  2. Choose how to install the agent: Ubuntu (systemd) or Docker.
  3. Select an existing enrollment key, or create a new one right there.
  4. Switch on any ROS options you need — the install command below updates as you go.

​
3) Install the agent on the device

On the target Ubuntu device, run the install command from the Add Device page. The installer configures and starts the insaion-agent systemd service automatically. See the full steps in Agent Installation.
The device registers itself, and the Agent status block on the Add Device page turns green once the agent is connected and reporting.

​
4) Verify in the web app

  • The device should appear online in Devices.
  • Open the device detail to see status, metrics, and configuration.
  • If you need to inspect the service locally, run sudo systemctl status insaion-agent.

​
5) Choose what the device collects

Open the device → Config → Data Collection. Each topic the agent discovered can be:
  • Monitored — ingested as live telemetry for dashboards and alarms.
  • Recorded — written to the on-device rolling buffer for incident playback.
Tick what you need and Save. See Device configuration for the full reference, or apply a Template to reuse a setup across devices.

​
6) Explore core features

  • Monitoring: check Logs and Dashboards to view telemetry.
  • Alarms: create a new alarm and configure notifications.
  • Templates & Sites: organize devices by site and reuse configurations.
  • Team: invite members and set permissions for collaboration.

​
Next steps