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

Troubleshooting: 'Something Went Wrong'

This error indicates missing Visual C++ runtime libraries:

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

🔄 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 () → Updates

Update Channels

You can switch between stable and beta 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