1.1.1. Host environment

This page outlines the steps to set up an environment for building with the Proximie SDK.

1.1.1.1. Prerequisites

  • Ubuntu 22.04 or 24.04

  • Ubuntu should be configured to use the XOrg/X11 display server, rather than Wayland; you can check this by running echo $XDG_SESSION_TYPE in a terminal – it should return x11.

1.1.1.2. Installation of Dependencies

The SDK has several build- and run-time dependencies that must be installed before building or running an application containing the SDK respectively. There are several ways to achieve this; in order of recommendation:

  • Install the SDK and its dependencies from our public APT repository at https://apt.proximiestaging.com. See APT-based Installation for details.

  • Switch to a Docker-based approach and follow the instructions in Docker environment; Proximie docker containers are pre-configured with all necessary dependencies.

  • Use scripts provided in the SDK release archive to install dependencies from our APT repository. After obtaining a release archive (see SDK release archives), you can run samples/environment/scripts/installers/dependencies.sh to install dependencies.

  • Use scripts provided in the SDK release archive to install dependencies manually. After obtaining a release archive (see SDK release archives), you can find scripts to install CMake v3.26.4, Boost v1.86, and the webrtcdsp GStreamer plugin in samples/environment/scripts/installers/.

  • Manually resolve and install dependencies yourself. See Dependencies for instructions on determining the dependencies required for building and running on your target system.