# Installation

Installation of `dv-runtime` is only provided on [{fa}`apple` Mac](#macos) and [{fa}`linux` Linux](#linux) systems.

## {fa}`apple` MacOS

The easiest way to install `dv-runtime` is via [Homebrew](https://brew.sh/). We provide a
[Homebrew tap](https://gitlab.com/inivation/homebrew-inivation/) for macOS. Install it with:

```bash
brew tap inivation/inivation
brew install dv-runtime
```

## {fa}`linux` Linux

### Ubuntu Linux

We provide a [PPA repository](https://launchpad.net/~inivation-ppa/+archive/ubuntu/inivation) for Focal (20.04 LTS),
Jammy (22.04 LTS) and Noble (24.04 LTS) on the x86_64, arm64 and armhf architectures.

These instructions also apply to [Raspberry Pi](https://ubuntu.com/download/raspberry-pi) and
[Nvidia Jetson](https://ubuntu.com/download/nvidia-jetson) embedded devices, both officially supported by the Ubuntu
operating system.

```bash
sudo add-apt-repository ppa:ubuntu-toolchain-r/test
sudo add-apt-repository ppa:inivation-ppa/inivation
sudo apt-get update
sudo apt-get install dv-runtime
```

### Fedora Linux

We provide a [COPR repository](https://copr.fedorainfracloud.org/coprs/inivation/inivation/) for recent Fedora releases
on the x86_64, arm64 and armhf architectures.

```bash
sudo dnf copr enable inivation/inivation
sudo dnf install dv-runtime
```

### Arch Linux

You can find `dv-runtime` as [a package in the AUR repository](https://aur.archlinux.org/packages/dv-runtime).

### Gentoo Linux

You can find `dv-runtime` as a valid Gentoo ebuild repository available
[here](https://gitlab.com/inivation/gentoo-inivation/) over Git. The package to install is 'dev-util/dv-runtime'.

### Embedded Devices

On most embedded devices, such as Raspberry Pi or Nvidia Jetson, you can follow the
[Ubuntu Linux instructions](#ubuntu-linux).

To start a `dv-runtime` instance, you might have to set the following environment variable: `UNW_ARM_UNWIND_METHOD=4`.
