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.
  3. Verify your email to unlock all features.

​
2) Invite your team (optional)

  • Navigate to Settings → Team → Invite.
  • Send invites by email and assign roles (Admin, Editor, Viewer).

​
3) Add your first device

  1. Go to Devices → Add Device.
  2. Choose Manual Pairing or Enrollment Key.
  3. Follow the instructions shown:
    • Manual pairing: copy the token and keep the tab open.
    • Enrollment key: copy the key for bulk/automated installs.

​
4) Install the agent on the device

On your Debian/Ubuntu device (ROS2 supported), install and start the agent. See the full steps in Agent Installation. Summary: 
# Download the correct bundle for your ROS2 distro
# Unzip, install, and start the agent
When prompted, use the pairing token or set the ENROLLMENT_KEY for automated registration.

​
5) Verify in the web app

  • The device should appear online in Devices.
  • Open the device detail to see status, metrics, and logs.

​
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.

​
Next steps