Janus Debian Package

Use CircleCI to build an ARMv7 Debian package for the Janus WebRTC server.

Overview

We use Docker as a build context for creating an ARMv7 (armhf) Debian package, with precompiled Janus binaries (see the Dockerfile for the complete build procedure). The resulting artifact is emitted to the releases/ folder. For example:

releases/janus_1.0.1-20220513_armhf.deb

Pre-requisites

• Raspberry Pi OS (32bit) Buster
• Docker
• Git

Build

On the device, run the following commands:

# Set the Janus version.
export PKG_VERSION='1.0.1'
export PKG_BUILD_NUMBER="$(date '+%Y%m%d')"
# Enable new Docker BuildKit commands:
# https://github.com/moby/buildkit/blob/master/frontend/dockerfile/docs/syntax.md
export DOCKER_BUILDKIT=1
# Build Debian package.
pushd "$(mktemp -d)" && \
  git clone https://github.com/tiny-pilot/janus-debian.git . && \
  docker build \
    --build-arg PKG_VERSION \
    --build-arg PKG_BUILD_NUMBER \
    --target=artifact \
    --output "type=local,dest=$(pwd)/releases/" \
    .

Install

On the device, run the following command:

# Install Janus. This is expected to fail, if there are missing dependencies.
# This leaves Janus installed, but unconfigured.
sudo dpkg --install \
  "releases/janus_${PKG_VERSION}-${PKG_BUILD_NUMBER}_armhf.deb"
# Install the missing dependencies and complete the Janus configuration.
sudo apt-get install --fix-broken --yes

You can confirm that the Janus systemd service is running, by executing the following command:

sudo systemctl status janus.service

Uninstall

On the device, run the following command:

sudo dpkg --purge janus