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

This version describes unreleased Nexigon Agent changes. For binaries of the current release, use Nexigon Agent 0.6.

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.