# Tuna Desktop

![](/docs/img/desktop/main.png) ![](/docs/img/desktop/list.png)

A detailed application overview is available in the [blog](https://tuna.am/en/blog/tuna-desktop-first.md).

## Installation

**Windows**

Download and install the full or portable version.

[![Installer for Windows x64 (requires administrator privileges)](/docs/img/getting-started/badge-exe-installer.svg "Installer for Windows x64 (requires administrator privileges)")](https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_installer_latest.zip)[![Portable version for Windows x64](/docs/img/getting-started/badge-exe-portable.svg "Portable version for Windows x64")](https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_portable_latest.zip)

🖌 Authenticity verification

Starting from version **v0.1.11**, all artifacts are signed using [cosign](https://docs.sigstore.dev/). To verify the originality of the archive, [install the cosign client](https://docs.sigstore.dev/cosign/system_config/installation/), download the public key, and perform the verification.

```shell
winget install sigstore.cosign
# installer
Invoke-WebRequest -Uri "https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_installer_latest.zip" -OutFile "tuna-desktop_windows-amd64_installer_latest.zip"
Invoke-WebRequest -Uri "https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_installer_latest.zip.bundle" -OutFile "tuna-desktop_windows-amd64_installer_latest.zip.bundle"
cosign.exe verify-blob --bundle=tuna-desktop_windows-amd64_installer_latest.zip.bundle tuna-desktop_windows-amd64_installer_latest.zip
# portable
Invoke-WebRequest -Uri "https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_portable_latest.zip" -OutFile "tuna-desktop_windows-amd64_portable_latest.zip"
Invoke-WebRequest -Uri "https://releases.tuna.am/desktop/latest/tuna-desktop_windows-amd64_portable_latest.zip.bundle" -OutFile "tuna-desktop_windows-amd64_portable_latest.zip.bundle"
cosign.exe verify-blob --bundle=tuna-desktop_windows-amd64_portable_latest.zip.bundle tuna-desktop_windows-amd64_portable_latest.zip

```

**macOS**

Download and install the macOS version.

[![Download DMG for macOS](/docs/img/getting-started/badge-dmg.svg "Universal version for all architectures")](https://releases.tuna.am/desktop/latest/tuna-desktop_darwin-universal_latest.dmg)

🖌 Authenticity verification

Starting from version **v0.1.11**, all artifacts are signed using [cosign](https://docs.sigstore.dev/). To verify the originality of the archive, [install the cosign client](https://docs.sigstore.dev/cosign/system_config/installation/), download the public key, and perform the verification.

```shell
brew install cosign
curl -sSLf -O https://releases.tuna.am/desktop/latest/tuna-desktop_darwin-universal_latest.dmg.bundle -O https://releases.tuna.am/desktop/latest/tuna-desktop_darwin-universal_latest.dmg
cosign verify-blob --bundle=tuna-desktop_darwin-universal_latest.dmg.bundle tuna-desktop_darwin-universal_latest.dmg

```

**Linux**

### Installation using script

Run the command in the terminal:

**curl**

```shell
sh -c "$(curl -sSLf https://releases.tuna.am/desktop/get.sh)"

```

**wget**

```shell
sh -c "$(wget -qO- https://releases.tuna.am/desktop/get.sh)"

```

tip

The script will detect your distribution, add the repository, and install the package.

### Install from the repository or download the package.

**Debian/Ubuntu**

For Debian and based distributions (Ubuntu, Mint, and others), run the following commands in the terminal:

```shell
sudo apt update
sudo apt install -y ca-certificates curl gnupg
curl -fsSL https://code.tuna.am/api/packages/tuna/debian/repository.key | sudo gpg --dearmor --batch --yes -o /usr/share/keyrings/tuna-forgejo.gpg
echo 'deb [signed-by=/usr/share/keyrings/tuna-forgejo.gpg] https://code.tuna.am/api/packages/tuna/debian stable main' | sudo tee /etc/apt/sources.list.d/tuna-forgejo.list
sudo apt update
sudo apt install -y tuna-desktop

```

tip

The repository contains builds for Debian 12+ / Ubuntu 22.04+

***

[![Download DEB x86_64 (for Debian 12+ / Ubuntu 22.04+)](/docs/img/getting-started/badge-deb-amd64.svg "Download DEB x86_64 (for Debian 12+ / Ubuntu 22.04+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop_latest-1_amd64.deb) [![Download DEB aarch64 (for Debian 12+ / Ubuntu 22.04+)](/docs/img/getting-started/badge-deb-arm64.svg "Download DEB aarch64 (for Debian 12+ / Ubuntu 22.04+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop_latest-1_arm64.deb)

For older OS (Debian 11- / Ubuntu 20.04-)

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

[![Download DEB x86_64 (for Debian 11- / Ubuntu 20.04-)](/docs/img/getting-started/badge-deb-amd64.svg "Download DEB x86_64 (for Debian 11- / Ubuntu 20.04-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop_latest-1_amd64.deb)[![Download DEB aarch64 (for Debian 12+ / Ubuntu 22.04+)](/docs/img/getting-started/badge-deb-arm64.svg "Download DEB aarch64 (for Debian 12+ / Ubuntu 22.04+)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop_latest-1_arm64.deb)

**SUSE/OpenSUSE**

For SUSE and OpenSUSE, run the following commands in the terminal:

```shell
sudo zypper addrepo --repo https://code.tuna.am/api/packages/tuna/rpm/stable.repo
sudo zypper install -y tuna-desktop

```

tip

The repository contains builds for SUSE/Leap 15.5+ and Tumbleweed

***

[![Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.x86_64.rpm) [![Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.aarch64.rpm)

For older OS (SUSE 15.4- / RHEL based 9- / ALT Linux p10- )

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

[![Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.x86_64.rpm)[![Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.aarch64.rpm)

**RHEL/Fedora**

For RHEL and based distributions (CentOS, Rocky Linux, AlmaLinux, as well as Fedora), run the following commands in the terminal:

```shell
sudo curl -fsSL https://code.tuna.am/api/packages/tuna/rpm/stable.repo -o /etc/yum.repos.d/tuna-forgejo.repo
sudo dnf install -y tuna-desktop

```

tip

The repository contains builds for RHEL/CentOS/AlmaLinux/Rocky Linux 10+

***

[![Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.x86_64.rpm) [![Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.aarch64.rpm)

For older OS (SUSE 15.4- / RHEL based 9- / ALT Linux p10- )

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

[![Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.x86_64.rpm)[![Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.aarch64.rpm)

**ALT Linux**

For [ALT Linux](https://www.basealt.ru/alt-workstation-k?utm_source=tuna.am&utm_medium=organic&utm_campaign=docs), run the following commands in the terminal:

```shell
sudo apt-get update
sudo apt-get install -y curl apt-repo
sudo rpm --import https://releases.tuna.am/tuna.asc
sudo apt-repo add rpm https://code.tuna.am/api/packages/tuna/alt/stable.repo $(arch) classic
sudo apt-get update
sudo apt-get install tuna-desktop

```

tip

The repository contains builds for ALT Linux p11+ and Sisyphus

Repository for ALT Linux p10-

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

```shell
sudo apt-get update
sudo apt-get install -y curl apt-repo
sudo rpm --import https://releases.tuna.am/tuna.asc
sudo apt-repo add rpm https://code.tuna.am/api/packages/tuna/alt/old.repo $(arch) classic
sudo apt-get update
sudo apt-get install tuna-desktop

```

***

[![Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.x86_64.rpm) [![Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+ )](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.5+ / RHEL based 10+ / Fedora / ALT Linux p11+)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1.aarch64.rpm)

For older OS (SUSE 15.4- / RHEL based 9- / ALT Linux p10- )

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

[![Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-amd64.svg "Download RPM x86_64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.x86_64.rpm)[![Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)](/docs/img/getting-started/badge-rpm-arm64.svg "Download RPM aarch64 (for SUSE 15.4- / RHEL based 9- / ALT Linux p10-)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1.aarch64.rpm)

**Arch Linux**

For Arch Linux, run the following commands in the terminal:

```shell
(
ARCH=$(uname -m)
URL="https://releases.tuna.am"
cd $(mktemp -d)
curl -sSLfO "${URL}/tuna.asc"
curl -sSLfO "${URL}/desktop/latest/tuna-desktop_latest_checksums_linux-pkgs.txt"
curl -sSLfO "${URL}/desktop/latest/current/tuna-desktop-latest-1-${ARCH}.pkg.tar.zst"
curl -sSLf "${URL}/desktop/latest/current/tuna-desktop-latest-1-${ARCH}.pkg.tar.zst.sig" -o tuna-desktop_latest.sig
sha256sum -c --ignore-missing tuna-desktop_latest_checksums_linux-pkgs.txt
gpg --batch --import tuna.asc
gpg --batch --verify tuna-desktop_latest.sig tuna-desktop-latest-1-${ARCH}.pkg.tar.zst
pacman -Sy
pacman -U tuna-desktop-latest-1-${ARCH}.pkg.tar.zst
)

```

***

[![Download PKG x86_64 (for Arch Linux)](/docs/img/getting-started/badge-pkg-amd64.svg "Download pkg x86_64 (for Arch Linux)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1-x86_64.pkg.tar.zst) [![Download pkg aarch64 (for Arch Linux)](/docs/img/getting-started/badge-pkg-arm64.svg "Download pkg aarch64 (for Arch Linux)")](https://releases.tuna.am/desktop/latest/current/tuna-desktop-latest-1-aarch64.pkg.tar.zst)

For older OS

Older versions depend on `libwebkit2gtk-4.0-37`, while newer ones already use `libwebkit2gtk-4.1-0`.

[![Download pkg x86_64 (for Arch Linux)](/docs/img/getting-started/badge-pkg-amd64.svg "Download pkg x86_64 (for Arch Linux)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1-x86_64.pkg.tar.zst)[![Download pkg aarch64 (for Arch Linux)](/docs/img/getting-started/badge-pkg-arm64.svg "Download pkg aarch64 (for Arch Linux)")](https://releases.tuna.am/desktop/latest/old/tuna-desktop-latest-1-aarch64.pkg.tar.zst)

***

## Update

On Windows and macOS, download the latest version using the links above and install it. On Linux, update the `tuna-desktop` package with your package manager (`apt`, `zypper`, `dnf`, `apt-get`) or run the install script again. On Arch Linux, repeat the installation commands: they download the latest version.

## Authorization

To use the client, you need a Token. Register [via this link](https://my.tuna.am/) and authorize the application. The token will be saved in the [config file](https://tuna.am/en/docs/guides/config-file.md), or you can copy it from a [separate page](https://my.tuna.am/token) and specify it manually.

Click **Sign in to the app**

![Sign in to the app](/docs/img/getting-started/desktop-login.png)

A link will open in the browser asking you to confirm the login, click **Sign in**

![Sign in to the tuna app](/docs/img/getting-started/desktop-login-browser.png)

Specify the token manually

Below the *Sign in to the app* button, click the **use token to sign in** link and enter the token from the [page](https://my.tuna.am/token):

![Sign in to the tuna app](/docs/img/getting-started/desktop-set-token.png)

## Get started

Everything is ready to start working. Create one or more tunnels and run them.

![Click - add tunnel](/docs/img/getting-started/desktop-use.png)

## What's next?

* Explore [HTTP tunnel](https://tuna.am/en/docs/tunnels/http.md) configuration examples
* Need access to a non-HTTP service? Learn more in the [TCP tunnel](https://tuna.am/en/docs/tunnels/tcp.md) section