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)
  • amd64 architecture

Other Linux Distributions

While officially tested on Ubuntu 22.04, the app may work with later versions and 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

Quick Install

# Add Zelos repository
echo "deb [trusted=yes] https://release.zeloscloud.io/app/ubuntu jammy main" \
    | sudo tee /etc/apt/sources.list.d/zelos.list

# Update package list
sudo apt update

# Install Zelos App
sudo apt install zelos-app

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 includes automatic update notifications:

  • An Update Available button appears in the top-right corner when updates are ready
  • Click to download and install with one click
  • Manual update check: Settings () → App → Updates

Update Channels

You can switch between the Release and Alpha update channels in the 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