---
title: "How to Install Retrace With Apt on Linux"
slug: "linux-installation-ubuntu-debian"
description: "Install the Retrace Linux Agent on Ubuntu and Debian systems with ease using the apt package manager. Configure with your activation key and restart."
updated: 2019-01-21T20:54:59Z
published: 2019-01-21T20:54:59Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ubuntu / Debian Installation

Instructions on how to install the Retrace Linux Agent on Ubuntu and Debian based Linux systems. You can install by using the **apt** package manager directly.

> The following commands are intended to be ran with root permissions.

## Installing with Apt

1. **Add Stackify’s apt repository.**

```
echo 'deb https://download.stackify.com/deb stable main' | sudo tee /etc/apt/sources.list.d/stackify.list
```

1. **Trust Stackify’s GPG key.**

```
wget -qO - https://download.stackify.com/GPG-KEY-stackify | sudo apt-key add -
```

1. **Update package list.**

```
sudo apt-get update
```

1. **Install Stackify Linux Agent.**

```
sudo apt-get install stackify-agent
```

1. **Configure Agent with your Retrace activation key.** You can find your **activation key**  in your Retrace account [**Settings** > **Account** > **Activation Key**](https://s1.stackify.com/Manage/AccountInfo).

![](https://support.stackify.com/wp-content/uploads/2017/10/LinuxAgent_Overview.png)

```
sudo stackify-agent-config --key "YOUR_ACTIVATION_KEY" --environment "Production" --devicealias [aliasname]
```

1. **Restart Agent.**

```
sudo service stackify-agent start
```

## Uninstalling with Apt

```
sudo apt-get remove stackify-agent
```

## Upgrading with Apt

```
sudo apt-get install --only-upgrade stackify-agent
sudo service stackify-agent restart
```