Compulab

Prerequisites

Crux VPN is currently validated only on the following Compulab devices:

For each model, only the latest build of the Compulab Debian Linux image is supported. You can download it from the "Resources" section of each linked product page above.

Supported OS versions:

- IOT-DIN-IMX8PLUS Debian Linux image - January 19, 2025
- IOT-GATE-IMX8PLUS and SBC-IOT-IMX8PLUS Debian Linux image - June 10, 2024
- IOT-GATE-IMX8 and SBC-IOT-iMX8 Debian Linux image - February 26, 2025

If your device does not come pre-installed with the correct version of the OS, make sure to install the correct version using the instructions provided by Compulab:

Installation

Before installing the Crux VPN Agent, run the following command to update your local list of packages using /etc/apt/sources.list:

sudo apt update

The steps below summarize the installation process and assume you have already generated the required configuration files in the Web UI.

Set Up New Agent

To set up a new agent for the host:

1. Create the agent configuration directory on the host:

 sudo mkdir -p /etc/cruxvpn/

2. If necessary move the configuration for any existing WireGuard interfaces you want the agent to monitor into the configuration directory:

 sudo mv wg0.conf /etc/cruxvpn/.

3. Download the cruxvpn.conf file generated within the Web UI, copy it to the host, and move it to the configuration directory:

 sudo mv cruxvpn.conf /etc/cruxvpn/.

4. Download the cruxvpn-setup.conf file generated within the Web UI, copy it to the host, and move it to the configuration directory:

 sudo mv cruxvpn-setup.conf /etc/cruxvpn/.

5. Download the Crux VPN Agent tarball:

 wget https://dl.sirius.computer/agents/cruxvpn-agent-latest.tar.gz

6. Copy the tarball to the host, and extract it:

 tar xf cruxvpn-agent-*.tar.gz

7. Run the install.sh script from the tarball as root, with the --install flag to activate the interactive installer:

cd cruxvpn-agent-*/
sudo ./install.sh --install

8. Enter y for all the prompts.

After installation, return to the host details page in the Web UI. The latest agent ping should now be visible.

Troubleshooting

To diagnose issues with the existing agent, try running the following command on the host:

sudo /opt/venvs/cruxvpn-agent/bin/cruxvpn-agent --test

For further assistance, head over to the troubleshooting section.