---
title: "Install Devo Relay on an Ubuntu box"
canonical: "https://docs.devo.com/space/latest/96469100/Install%20Devo%20Relay%20on%20an%20Ubuntu%20box"
format: markdown
---
> Macro (toc)

This article takes you step by step through the **installation of Devo Relay on a machine running Ubuntu**. We will install the most recent version of Devo Relay using a .deb package that resides in Devo public repository.

If you are using an old version of Devo Relay and want to migrate to the most recent version, go to [“Relay migration“ guide](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469938). 

## Before you begin

Make sure you can provide a machine with the [specified requirements](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469035).

## Installing Devo Relay 

Follow these instructions to **install the .deb package that contains the relay.**

> ⚠️ **Important: Java versions**
> ⚠️ 
> ⚠️ Please note that the devo-ng-relay and CLI require Java 17 to work. Other Java versions are not supported. The devo-ng-relay package includes this required Java version (Java 17) so please consider uninstalling any other version you may have, or use the Linux command update-alternatives to make Java 17 the default Java.

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> **Import the Devo repository public key** using these commands:
> 
> **For Ubuntu 22**
> 
> ```
> $ wget -qO - https://packages.devo.com/devo-archive-keyring.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/devo.gpg
> ```
> 
> ```
> $ echo "deb [signed-by=/etc/apt/keyrings/devo.gpg] https://packages.devo.com/ jammy devo" | sudo tee /etc/apt/sources.list.d/devo.list
> ```
> 
> **For Ubuntu 24 or later**
> 
> ```
> $ wget -qO - https://packages.devo.com/devo-archive-keyring.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/devo.gpg
> ```
> 
> ```
> $ echo "deb [signed-by=/etc/apt/keyrings/devo.gpg] https://packages.devo.com/ noble devo" | sudo tee /etc/apt/sources.list.d/devo.list
> ```
> 
> > Macro (rw-step)
> 
> **Update the resources list.**
> 
> ```
> sudo apt-get update
> ```
> 
> > Macro (rw-step)
> 
> Install the relay package and [the relay command-line interface (CLI)](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469683) using this command:
> 
> ```
> sudo apt-get install devo-ng-relay
> ```
> 
> > Macro (rw-step)
> 
> It is highly recommended that you install the** devo-monitor **package, which installs scripts that **monitor machine status (CPU, memory, IO traffic)** so their values can be sent to the Devo endpoint. The events collected by this package will be available in the `box.stat.unix.*` tables of your Devo domain. You can install this package using the following command: 
> 
> > ⚠️ Note that upgrade to `devo-monitor v2.1.2` is required for Ubuntu 24.
> 
> ```
> sudo apt install devo-monitor
> ```
> 
> > Macro (rw-step)
> 
> Finally, you must **configure your relay and then activate it on the Devo platform**. See the [Devo Relay setup process](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469732).
> 
> You can relaunch the set up process at any time after the installation if needed.

<span style="color: #ffffff">.</span>

#### Related articles

- [Set up your relay](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469732)
- [Relay troubleshooting tips (v2.0.0)](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96470133)
- [Managing Devo Relay on the command line](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469918)
- [Configuring Devo Relay](https://devodocs.atlassian.net/wiki/spaces/latest/pages/96469224)