Installing on Linux¶

Edge Insights runs on Linux in two ways:

Desktop PC: covered on this page. Edge Insights is installed as a normal desktop application and started from the application menu.
Embedded / headless device: the device monitors a bus continuously and the portal is accessed over the network. See Installing on an embedded device.

Requirements¶

An x86_64 PC. arm64 builds are also available; see the embedded install page.
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-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. It copies the stack into your home directory, registers the background services, and adds Edge Insights to your application menu:
```
sudo ./install.sh
```
- 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.

Network access¶

By default the portal is reachable only from the device that's running it, at http://localhost:36300. This keeps Edge Insights off the local network.

To open the portal from another machine on the same network, install with --access network:

sudo ./install.sh --access network

This binds the portal and the Grafana dashboards to all network interfaces. Use it only on a trusted network. The portal has no login.

The installer remembers this choice. Running it again without --access keeps the current mode. To switch back to local-only, run:

sudo ./install.sh --access local

Starting at boot¶

On a desktop install the stack runs while Edge Insights is open and stops when you close it. Nothing starts on its own at boot.

For a machine that should keep recording without anyone opening the application, install with --boot-autostart:

sudo ./install.sh --boot-autostart

The installer remembers this choice, and --no-boot-autostart turns it off again. With it on, the CAN Settings page gains a Boot Autostart option that controls whether capture also starts, or only the portal. See CAN Settings.

Launch¶

Start Edge Insights from the application menu, like any other desktop application.

The application starts the analytics services and opens the portal in its own window. When you close the window, the services it started are stopped again. Nothing keeps running in the background.

Uninstall¶

From the extracted tarball directory:

sudo ./uninstall.sh

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

sudo ./uninstall.sh --purge