Link Search Menu Expand Document

How to Configure the VOXL Package Manager

Table of contents

  1. Overview
  2. Available Sections
    1. sdk-x.y
    2. Staging
    3. Dev
  3. Keeping updated


The VOXL SDK is distributed as both a pre-built installer and as a publicly accessible Debian Package Repo Here. After flashing your VOXL with an SDK installer, VOXL will be configured to point its package manager to the correct Debian Package Repo online to allow for updates.

This page describes how to use the voxl-configure-pkg-manager script to configure the package manager to pull from a particular release section.

Generally you do NOT need to use this tool unless you know what you are doing and have a good reason to change from a stable SDK distribution.

Available Sections

All ModalAI package repositories are available at allowing opkg or apt to install and update packages using an internet connection.


We will periodically assemble all of our packages into a tested and stable SDK release. These are enumerated to match the version of voxl-suite within (i.e. SDK-0.8 has voxl-suite version 0.8 and its dependencies). These releases are considered stable and receive new updates and features that should not break APIs.

An SDK minor version release is tied to a system image version so you cannot upgrade to a newer SDK with the voxl-configure-package-manager tool. You must follow the SDK installer instructions.


This is the default-enabled repository on nightly SDK builds and consists of packages being tested and staged for stable release. These are experimental packages with features that will appear in future stable SDK releases.


This is the development repository containing often untested or experimental software that is automatically pushed via CI on every commit made by ModalAI’s software team. This repository serves for ModalAI to use internally. Packages on this repo are updated very regularly and are not guaranteed to function.

Keeping updated

You can easily check to see if any updated packages are available to pull by running opkg update && opkg upgrade on VOXL 1 or apt update && apt upgrade on VOXL 2. Especially if you decide to use the staging repo, new packages will often be available weekly if not daily.

Additional Note on APT:

VOXL2/RB5F are built on a standard Ubuntu 18 image, so we recommend that you run apt update && apt upgrade regularly on these platforms no matter what as there will often be updates to the standard Ubuntu packages even if there haven’t been to ours.