---
title: "Installing on Linux"
slug: "installing-on-linux"
updated: 2025-08-19T14:42:41Z
published: 2025-08-19T14:42:41Z
---

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

# Installing on Linux

This guide provides step-by-step instructions for installing and configuring the NordLayer application on Linux-based operating systems.

          Please note that this guide is meant for client machines and not servers

          

## Installation process

**1. Download the package for your Linux distribution from the [downloads page](https://nordlayer.com/download/linux/)**

**2. Install the package**

During the installation both the repository and the application will be installed. Additionally, a new user and user group `nordlayer` will be created and you will be added to this group.

To install, you can double-click on the downloaded file or run the commands bellow in the terminal.

**Ubuntu/Debian**

```
sudo apt install <path-to-downloaded-deb-file>
```

**Fedora**

```
sudo dnf install <path-to-downloaded-rpm-file>
```

**openSUSE**

```
sudo zypper install <path-to-downloaded-rpm-file>
```

**3. Optional: install systray application**

A graphical system tray application is available, allowing to manage NordLayer connections without the terminal. Not all features are supported. For full functionality always use the terminal application.

![image.png](https://cdn.document360.io/fc1049cd-8f71-4b89-b9b8-dbca9fdcdd16/Images/Documentation/image%2811%29.png)

**Ubuntu Debian**

```
sudo apt update && sudo apt install nordlayer-tray
```

**Fedora**

```
sudo dnf install nordlayer-tray
```

**openSUSE** For systray functionality on openSUSE, you will need to add the appropriate repository and refresh it prior to the installation. Use the following commands:

```
zypper addrepo https://download.opensuse.org/repositories/home:huakim:matrix/openSUSE_Tumbleweed/home:huakim:matrix.repo
zypper refresh home_huakim_matrix
sudo zypper install nordlayer-tray
```

## Relogin or reboot

For the group assignment to take effect re-login to your desktop user or reboot the system. Otherwise permission error is encountered.

**Note:** If you install systray separately, you will need to re-login again for the changes to take effect.

## Upgrade

For best experience and compatibility between the main application and systray, always upgrade both to the latest version.

**Ubuntu/Debian** Run the following commands:

```
sudo apt update && sudo apt install nordlayer nordlayer-tray
```

**Fedora** Run the following commands:

```
sudo dnf update nordlayer nordlayer-tray
```

**openSUSE** Run the following commands:

```
sudo zypper update nordlayer
```

---

**Note**: In case you have any questions or are experiencing any issues, please feel free to contact our [24/7 customer support team](/docs/how-do-i-contact-nordlayer-customer-support).