Installation

Prerequisites

For CAN and VCAN support, RemotiveBus requires SocketCAN to be installed on the host. SocketCAN provides CAN drivers as well as tooling to work with CAN networks.

To get the best leverage using SocketCAN the following kernel modules are also required, service emits error if any of the following is missing:

• vxcan (kernel option: CONFIG_CAN_VXCAN)
• can-gw (kernel option: CONFIG_CAN_GW)
• vcan (kernel option: CONFIG_CAN_VCAN)

If startup fails with a missing module error, install the kernel module package for your distro/kernel. On Ubuntu, this is often:

sudo apt install linux-modules-extra-$(uname -r)

Installation

Debian/Ubuntu (apt)

curl -fsSL \
  https://packages.remotivelabs.com/apt-repo-signing-key.gpg \
  | sudo gpg --dearmor -o /usr/share/keyrings/remotivelabs-apt.gpg

echo "deb [signed-by=/usr/share/keyrings/remotivelabs-apt.gpg] \
  https://packages.remotivelabs.com remotivelabs-apt main" \
  | sudo tee /etc/apt/sources.list.d/remotivelabs.list

sudo apt update
sudo apt install remotivebusd

Red Hat/CentOS/Fedora (yum/dnf)

sudo tee /etc/yum.repos.d/remotivelabs.repo > /dev/null <<EOF
[remotivelabs]
name=Remotivelabs
baseurl=https://packages.remotivelabs.com/yum/remotivelabs-yum
enabled=1
EOF

sudo dnf install remotivebusd

Manual installation

To install RemotiveBus manually, download the desired version from:

https://releases.remotivelabs.com/#remotivebus/

This contains all variants of the package for both x86 and ARM architectures.

Once downloaded, it can be unpacked and installed by:

mkdir remotivebus
tar xvf remotivebus-VERSION.tar.gz -C remotivebus
cd remotivebus
make
cd ..
rm -rf remotivebus

Podman

Podman works in both rootful and rootless mode but to enable rootless mode you must add your user to the remotivebus Linux group.

sudo usermod -aG remotivebus <your_username>