Skip to content

Zelos App Installation

The Zelos App is a desktop application for capturing and viewing tracing data in real-time.

System Requirements

  • macOS 10.15 (Catalina) or later
  • Apple Silicon (M1/M2/M3) or Intel processor
  • Ubuntu 22.04 LTS (Jammy) or 24.04 LTS (Noble)
  • amd64 architecture

Other Linux Distributions

Zelos is tested on Ubuntu 22.04 and 24.04. It may work on other Debian-based distributions.

  • Windows 10 version 1809 or later
  • 64-bit (amd64) architecture
  • Microsoft Visual C++ Redistributable

Installation

Download

Choose your processor type:

Install

  1. Locate the downloaded .zip file in your Downloads folder
  2. Double-click to extract the archive
  3. Drag Zelos.app to your Applications folder
  4. Double-click Zelos.app to launch

First Launch Security

macOS may show a security warning on first launch:

  1. Click Cancel on the security dialog
  2. Open System Settings → Privacy & Security
  3. Find Zelos and click Open Anyway
  4. Enter your password when prompted

Download

Download the Ubuntu .deb from zeloscloud.io/download, then install it from a terminal:

cd ~/Downloads
sudo apt install ./zelos-app_amd64.deb

Or install it from the desktop. On Ubuntu 24.04, double-click the .deb to open it in App Center, then click Install. On Ubuntu 22.04, right-click the .deb in Files, choose Open With → Software Install, then click Install.

The package adds the signed Zelos apt repository to your system. The Update button in Zelos and Ubuntu's Software Updater then keep Zelos current.

Install from the apt repository instead

To install without downloading the .deb first, add the Zelos repository and install with apt:

# Remove an old Zelos source so apt does not list Zelos twice
sudo rm -f /etc/apt/sources.list.d/zelos.list

# Add the Zelos signing key and repository
sudo wget -qO /usr/share/keyrings/zelos-archive-keyring.gpg https://release.zeloscloud.io/app/zelos-archive-keyring.gpg
printf '%s\n' 'Types: deb' 'URIs: https://release.zeloscloud.io:443/app/ubuntu' 'Suites: jammy' 'Components: main' 'Signed-By: /usr/share/keyrings/zelos-archive-keyring.gpg' | sudo tee /etc/apt/sources.list.d/zelos.sources

# Install Zelos App
sudo apt update
sudo apt install zelos-app

Keep jammy on Ubuntu 24.04 too. It is the repository's name, not your Ubuntu version.

Launch the Application

zelos-app

Create Desktop Shortcut

After launching the app:

  1. Right-click the Zelos icon in your dock
  2. Select Add to Favorites

Pro Tip

You can also launch Zelos from the Activities overview by pressing ++super++ and typing "Zelos"

Download

Install

  1. Locate Zelos Setup.exe in your Downloads folder
  2. Double-click to run the installer

  3. Follow the installation wizard:

    • Accept the license agreement
    • Choose installation location (or use default)
    • Click Install

  4. The app launches automatically after installation

'Something Went Wrong' on first launch

On a fresh Windows machine this is usually a missing Visual C++ runtime:

  1. Download the VC++ Redistributable x64
  2. Run the installer and restart your computer
  3. Launch Zelos again

If the app has worked before, the cause is more often another program holding port 2300. See Troubleshooting.

🔄 Updates

Zelos checks for updates automatically:

  • An Update available badge appears on Settings () in the sidebar when a new version is ready
  • Open Settings → App → Updates and click Update and Restart App to install it
  • Click Check for Update in the same section to check right away

On Ubuntu, Zelos updates through the system package manager. An administrator account needs no password. Ubuntu's Software Updater also installs Zelos updates. If you installed Zelos from the apt repository before it was signed, you do not need to do anything. Your next Zelos update moves you to the signed repository and keeps your update channel.

Update Channels

You can switch between the Release and Alpha update channels in the settings. See Settings.

📚 Next Steps

  • Read the User Guide

    Learn about all features and capabilities

    App Guide

  • Install the SDK

    Start sending your own data to Zelos

    SDK Installation