Nexigon Agent

Nexigon Agent runs on a device and connects it to Nexigon Hub. It provides remote access, device properties, event emission, and optional command execution. Binaries are available for Linux, macOS, and Windows; feature availability varies by platform.

Choose a Setup Guide

Getting Started connects a Linux device using the installation script.
Getting Started with Rugix adds Nexigon Agent to a Rugix Bakery image.
Firmware Images links the Yocto and Rugix build integrations for embedded Linux.
Device Provisioning pairs devices with a one-use token and prepares a production handoff.

Installation and Setup

Download Nexigon Agent 0.6.1 for your device:

See Nexigon Agent releases for checksums and other builds. For manual installation, choose the binary for the device’s architecture and make it executable on Linux or macOS. Configure credentials and a fingerprint script as described in Configuration. The setup guides above cover Linux service installation.

Linux Service

For a manual Linux installation with systemd, place Nexigon Agent at /usr/bin/nexigon-agent and save this unit as /etc/systemd/system/nexigon-agent.service:

[Unit]
Description=Nexigon Agent
After=network.target

[Service]
Type=exec
PIDFile=/run/nexigon-agent.pid
ExecStart=/usr/bin/nexigon-agent run
ExecStop=-/sbin/start-stop-daemon --quiet --stop --retry QUIT/5 --pidfile /run/nexigon-agent.pid
TimeoutStopSec=5
KillMode=mixed
Restart=always
RestartSec=60s
LimitNOFILE=8192

[Install]
WantedBy=multi-user.target

After configuring Nexigon Agent, load and start the service:

systemctl daemon-reload
systemctl enable --now nexigon-agent
journalctl -u nexigon-agent

NixOS

The Nexigon flake provides the nexigon-agent package and nixosModules.nexigon-agent module. The module configures the service, keeps credentials in a private persistent directory, and enables provisioning only when requested.

See NixOS Nexigon Agent Integration for configuration and options. Pin a Nexigon revision that includes the module.

Edit this page