openZro

Linux Installation

The openZro client (agent) lets a peer join an existing openZro network. If a deployment isn't ready yet, follow the self-host quickstart to stand one up — there is no managed cloud.

The recommended install method is the signed APT or YUM/DNF/zypper repository at pkg.openzro.io. It tracks every release tag and uses the same GPG key for the metadata across distributions, so the trust path is consistent.

Ubuntu / Debian (APT)

sudo apt-get update
sudo apt-get install -y ca-certificates curl gnupg

# Trust the openZro signing key
curl -fsSL https://pkg.openzro.io/openzro-archive-keyring.gpg \
  | sudo tee /usr/share/keyrings/openzro-archive-keyring.gpg > /dev/null

# Add the repository
echo "deb [signed-by=/usr/share/keyrings/openzro-archive-keyring.gpg] \
https://pkg.openzro.io/apt stable main" \
  | sudo tee /etc/apt/sources.list.d/openzro.list > /dev/null

sudo apt-get update
sudo apt-get install -y openzro       # CLI / daemon
sudo apt-get install -y openzro-ui    # optional desktop UI (system tray)

RHEL / Fedora / Amazon Linux (YUM / DNF)

sudo tee /etc/yum.repos.d/openzro.repo > /dev/null <<EOF
[openzro]
name=openZro
baseurl=https://pkg.openzro.io/rpm/\$basearch
enabled=1
gpgcheck=1
gpgkey=https://pkg.openzro.io/openzro-archive-key.asc
repo_gpgcheck=1
EOF

# RHEL 9 / Fedora / Amazon Linux 2023 use dnf
sudo dnf install -y openzro
sudo dnf install -y openzro-ui   # optional, for desktop UI

# RHEL 7 / Amazon Linux 2 use yum
sudo yum install -y openzro

If your distribution has split out app-indicator support (common on Fedora 38+ / GNOME 44+), you may also need:

sudo dnf install -y gnome-shell-extension-appindicator
sudo gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com

Restart GNOME Shell (X11: Alt+F2, r, ⏎ — Wayland: log out and log back in) so the system tray icon appears.

openSUSE / SLES (zypper)

sudo zypper addrepo https://pkg.openzro.io/rpm/x86_64 openzro
sudo rpm --import https://pkg.openzro.io/openzro-archive-key.asc
sudo zypper install openzro

Replace x86_64 with aarch64 on ARM64 hosts.

Direct download (if you can't use a package repo)

Every release publishes pre-built binaries to GitHub Releases. Pick the asset matching your OS / architecture and unpack:

# CLI / daemon — replace VERSION with the tag you want
VERSION=v0.1.0-alpha.2
ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/')
curl -L -o openzro.tar.gz \
  "https://github.com/openzro/openzro/releases/download/${VERSION}/openzro_${VERSION#v}_linux_${ARCH}.tar.gz"
tar -xzf openzro.tar.gz
sudo install -m 0755 openzro /usr/local/bin/openzro

The release page also carries .deb and .rpm files if you prefer to install one-off without configuring a repo:

# Debian / Ubuntu
curl -LO "https://github.com/openzro/openzro/releases/download/${VERSION}/openzro_${VERSION#v}_linux_${ARCH}.deb"
sudo dpkg -i openzro_${VERSION#v}_linux_${ARCH}.deb

# RHEL / Fedora
curl -LO "https://github.com/openzro/openzro/releases/download/${VERSION}/openzro_${VERSION#v}_linux_${ARCH}.rpm"
sudo dnf install ./openzro_${VERSION#v}_linux_${ARCH}.rpm

After install

The openzro daemon is installed but not connected to a network yet. Run:

sudo openzro service install
sudo openzro service start
sudo openzro up --management-url https://your-management.example.com:443 \
                --setup-key <YOUR_SETUP_KEY>

Verify:

sudo openzro status -d

For the desktop UI, launch openzro-ui from your application menu (it integrates with the system tray) or start the daemon then run openzro-ui from the shell.

Get started