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)

Quick install

Install or upgrade with a single command:

curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash

info

RemotiveBus runs on Linux only.

Install script options

To pass options through curl … | bash, add -s -- before them:

# Install a specific version
curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash -s -- 0.11.3

# Force a reinstall even if already up to date
curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash -s -- -f

# Non-interactive (no prompts)
curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash -s -- -y

# Force a backend instead of auto-detecting (apt|yum|tar)
curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash -s -- --method tar

# Print what would happen without changing anything
curl -fsSL https://files.remotivelabs.com/remotivebus/install.sh | bash -s -- --dry-run

How the script installs per platform

Platform	Method
Debian / Ubuntu	apt + RemotiveLabs apt repository
Red Hat Enterprise Linux (RHEL) / Fedora	dnf/yum + RemotiveLabs yum repository
Other Linux (e.g. Arch)	installer tarball, verified against its SHA-256 digest

The installer tarball bundles the deb/rpm/pacman packages and installs via whichever of dpkg/dnf/pacman the host has, so every method ends in a proper package install—upgrades and uninstall go through your package manager.

Manual install

If you prefer to manage the installation yourself, choose your platform and use one of the methods below instead of the install script.

Debian/Ubuntu (apt)

Add the RemotiveLabs apt repository (the same one that serves the RemotiveCLI—skip this if you already added it) and install:

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

Upgrade:

sudo apt update
sudo apt install remotivebusd

Red Hat/CentOS/Fedora (yum/dnf)

Add the RemotiveLabs yum repository (the same one that serves the RemotiveCLI—skip this if you already added it) and install:

sudo tee /etc/yum.repos.d/remotivelabs.repo > /dev/null <<EOF
[remotivelabs]
name=RemotiveLabs
baseurl=https://packages.remotivelabs.com/yum/remotivelabs-yum
enabled=1
repo_gpgcheck=0
gpgcheck=1
gpgkey=https://files.remotivelabs.com/remotivebus/remotivelabs-rpm-signing-key.gpg
EOF
sudo dnf install remotivebusd

Upgrade:

sudo dnf upgrade remotivebusd

On the first install, dnf asks you to confirm the import of the RemotiveLabs signing key. Its fingerprint is:

97AD 3C39 C481 B264 EECC  C165 67AB C659 C983 948B

info

Packages are GPG-signed from v0.11.3 onwards. To install an older (unsigned) version, pass --nogpgcheck to dnf.

Installer tarball

An installer tarball for distributions without apt or dnf, available for x86_64 and arm64. It bundles the deb/rpm/pacman packages together with a Makefile that installs via whichever of dpkg/dnf/pacman the host has, so it still ends in a proper package install. It requires make and one of those package managers.

Download, verify against the published SHA-256 digest, and install:

VERSION=$(curl -fsSL https://files.remotivelabs.com/remotivebus/latest/latest-version.txt)
curl -fsSL -O "https://files.remotivelabs.com/remotivebus/remotivebus-$VERSION.tar.gz"
curl -fsSL -O "https://files.remotivelabs.com/remotivebus/remotivebus-$VERSION.tar.gz.sha256"
sha256sum -c "remotivebus-$VERSION.tar.gz.sha256"
mkdir remotivebus
tar -xzf "remotivebus-$VERSION.tar.gz" -C remotivebus
make -C remotivebus install

To uninstall, run make -C remotivebus uninstall, or remove the remotivebusd package with your package manager.

Verify installation

The package enables and starts the remotivebusd service. Verify that it's running:

systemctl status remotivebusd.service

If the service isn't running, check the logs with sudo journalctl -u remotivebusd.service—a common cause is missing kernel modules (see Prerequisites).

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>