Installing on an Embedded Device¶

Edge Insights can run headless on an embedded Linux device, for example an arm64 industrial PC. The services run continuously in the background, and the portal is accessed from a browser on another machine on the same network.

If you're installing on a desktop PC instead, see Installing on Linux.

Requirements¶

An arm64 or x86_64 device. Tarballs are published for both architectures
Ubuntu 22.04+ or Debian 12+. Other systemd-based distributions may work but are untested.
systemd with user services (systemctl --user)
The can kernel module, i.e. SocketCAN, also vcan if you want a virtual bus for testing without hardware
sudo / root access to run the installer

Install¶

Download the tarball for your architecture, edge-insights-<version>-linux-arm64.tar.gz or ...-linux-x86_64.tar.gz, extract it, and enter the extracted directory. It contains install.sh, uninstall.sh, dist/, and systemd/:
```
tar -xzf edge-insights-*-linux-*.tar.gz
cd edge-insights-*-linux-*
```
Run the installer with --start --access network --boot-autostart. It copies the stack into your home directory, registers the systemd --user services, starts them immediately, makes the portal reachable over the network, and brings the stack back up after every reboot:
```
sudo ./install.sh --start --access network --boot-autostart
```
- --access network binds the portal and the Grafana dashboards to all network interfaces, so you can reach them from another machine. Without it the portal is reachable only on the device itself, at localhost. Use network access only on a trusted network. The portal has no login. The installer remembers this choice, so you do not need to repeat the flag when you install again.
- --boot-autostart starts the stack when the device boots, with nobody logged in. Use it for a device that should keep recording on its own. Without it, nothing starts until you start it. The installer remembers this choice too. Use --no-boot-autostart to turn it off again.
- Omit --start to install without starting. Start later with systemctl --user start analytics.target.
- Add --with-vcan to load the vcan kernel module during install. Useful for a virtual test bus when no CAN hardware is attached.
The installer also grants the CAN capture service the CAP_NET_ADMIN capability, so it can configure CAN interfaces on its own.
Open the portal from a browser on another machine on the same network:

http://<device-hostname-or-ip>:36300

On the device itself it is also available at http://localhost:36300. From there, select the CAN interface to capture and upload a DBC file to start decoding signals.

Reaching the device through a custom DNS name, a reverse proxy, or a tunnel instead of its hostname or IP needs an extra step: see The portal loads, but every save or upload fails.

Managing the stack¶

Start or stop everything:

systemctl --user start analytics.target
systemctl --user stop  analytics.target

Start automatically at boot (opt-in):

systemctl --user enable analytics.target

Follow the logs:

journalctl --user -u 'analytics-*' -f --no-hostname -o short-iso

Uninstall¶

sudo ./uninstall.sh

This stops the services and removes the installed binaries. It prompts before deleting your data, e.g. analytics database, uploaded DBC files, imported logs. To remove everything without prompting:

sudo ./uninstall.sh --purge