Skip to main content
Version: 1.0

Linux Agent Service

Overview

Run the zrok agent as a systemd --user service under your Linux user account.

Install the Package

The package provides the zrok executable and the zrok-agent.service unit.

  1. Set up zrok's Linux package repository by following the Linux install guide, or run this one-liner to complete the repo setup and install packages.

    curl -sSLf https://get.openziti.io/install.bash \
    | sudo bash -s zrok-agent
  2. If you set up the repository by following the guide, then also install the zrok-agent package. This package provides the systemd service.

    Ubuntu, Debian
    sudo apt install zrok-agent
    Fedora, Rocky
    sudo dnf install zrok-agent

Enable your Account

This creates a ~/.zrok directory enabled for your zrok account.

zrok enable <your_account_token>

Start the Service

systemctl --user enable --now zrok-agent.service

Use the agent

Learn more about using the zrok agent in the agent guide.

Troubleshooting

Check the User Service Log

journalctl --user -lfu zrok-agent.service