Install and Upgrade
Insight is bundled with the Neat Development Environment. It can also be installed directly on a Modalix DevKit and upgraded with sima-cli neat install.
In the Neat Development Environment
When the SDK container starts with Insight enabled, Insight is installed, configured, and supervised automatically. The server listens over HTTPS and the SDK publishes a set of host ports for the browser, DevKit, and other external clients.
Check the service state:
insight-admin status
Open Insight from a browser:
https://localhost:9900
If you are browsing from another machine on the same network, use the SDK host IP address:
https://<host-ip>:9900
The default web UI port is 9900, but the SDK can allocate a different host port if 9900 is already in use. The neat command reports the actual Insight Web UI URL and exposed port mapping:
neat --json
Use insight.webUiUrl for the main UI. Use the exposedPorts array when configuring DevKit applications, RTSP clients, or external media senders.
On a DevKit
Insight can be installed directly on a Modalix DevKit. This is useful when you want the inspection console to run on the target device, or when you are validating a standalone DevKit setup.
Install Insight with sima-cli:
sima-cli neat install insight@{release-tag}
For development builds, replace the release tag with the branch or tag you want to install:
sima-cli neat install insight@main
After installation, activate the created virtual environment and start Insight:
source ~/.simaai/neat-insight/venv/bin/activate
neat-insight --port 9900
Then open:
https://<devkit-ip>:9900
When Insight runs directly on the DevKit, applications on that DevKit can usually use the default local ports. When applications outside the DevKit connect to it, use the DevKit IP address and the ports exposed by that Insight instance.
Upgrade Insight
Because Insight is packaged as a Neat artifact, you can upgrade it with the same sima-cli neat install flow used for installation.
For a release:
sima-cli neat install insight@{release-tag}
For the latest build from a branch:
sima-cli neat install insight@main
In the Neat Development Environment, Insight normally runs from /opt/neat-insight/venv. To upgrade the supervised SDK instance, install into that virtual environment and restart the service:
NEAT_INSIGHT_VENV_DIR=/opt/neat-insight/venv sima-cli neat install insight@main
supervisorctl restart neat-insight
If your SDK image requires elevated permissions for /opt/neat-insight, run the install command with the appropriate privileges for your environment.