Download

Cosmos Client is free and the same on every device: the same interface, profiles and settings. Get it on the Download page.

Platform	Where	Requirements
iPhone and iPad	App Store	iOS 15 or later
Android	Google Play	Android 7.0 or later
Mac	App Store	macOS 13 or later
Windows	.exe installer	Windows 10 or 11, 64-bit
Linux	Install script	x86_64, systemd

iPhone, iPad and Mac

Install from the App Store — the link is on the Download page. On first connection, the system will ask to allow adding a VPN configuration — allow it, you can’t connect without it.

The widget and Shortcuts work on iOS 17 or later.

Updates come through the App Store. To remove the app, delete it as usual — profiles and settings are deleted with it.

Android

Install from Google Play — the link is on the Download page. On first connection, the system will ask to allow Cosmos Client to set up a VPN connection — allow it, you can’t connect without it.

Updates come through Google Play. To remove the app, uninstall it as usual — profiles and settings are deleted with it.

Windows

Download the cosmos-client-windows-x64-setup.exe installer from the Download page and run it — administrator rights are required. It installs the app to Program Files\Cosmos Client and the cosmos-client-daemon service that keeps the connection up: VPN keeps working even when the window is closed.

To update, run the installer of the new version — it installs over the old one. To remove: Settings → Apps → Cosmos Client → Uninstall; the service is removed with the app.

Linux

For x86_64 with systemd: Ubuntu 20.04 or later, Debian 11 or later, Fedora, RHEL / Rocky / Alma 9 or later, openSUSE Tumbleweed, Arch. Run this command in your terminal:

curl -fsSL https://cosmosclient.dev/install.sh | bash

Use the copy icon on the Download page to copy the command. The installer selects the package for your distribution, verifies its checksum and installs it with your system’s package manager. It asks for your administrator password when needed; if jq is missing, it offers to install it first.

The package installs the app — a “Cosmos Client” shortcut appears in the app menu — and the cosmos-client-daemon service that keeps the connection up. In GNOME, the tray icon is shown through the AppIndicator extension: it is enabled in Ubuntu; in Fedora and Arch you may need to install it.

The app offers new releases when they are available. Choose Update and approve the system’s password prompt, then restart the app when prompted. If your system does not support installation from the app, run the command above again — it updates the same package and keeps your profiles and settings.

The old AppImage installed by the previous Cosmos Client installer remains a separate app. Close it before connecting with the new client; its files and profiles are kept.

To remove:

sudo apt remove cosmos-client      # Debian, Ubuntu
sudo dnf remove cosmos-client      # Fedora, RHEL
sudo zypper remove cosmos-client   # openSUSE
sudo pacman -R cosmos-client       # Arch

Next

Add a profile — without one there is nothing to connect to.