Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.insaion.com/llms.txt

Use this file to discover all available pages before exploring further.

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 Manual Pairing or Enrollment Key.
  3. Follow the instructions shown:
    • Pairing token: the wizard prepares a Linux install command, then you generate a token after the agent is running.
    • Enrollment key: the wizard prepares a Linux install command with the key included for automatic registration.

​
3) Install the agent on the device

On the target Ubuntu device, run the Linux install command from the Add Device wizard. The installer configures and starts the insaion-agent systemd service automatically. See the full steps in Agent Installation. 
curl -fsSL https://get.insaion.com/setup.sh | sudo bash
If you chose Enrollment Key, the device should register automatically. If you chose Pairing Token, open http://localhost:9090 or http://<device-ip>:9090, generate the pairing token in the dashboard, and complete registration there.

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