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 zrok2-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 zrok2-agent

2. If you set up the repository by following the guide, then also install the zrok2-agent package. This package provides the systemd service.

   Ubuntu, Debian

   sudo apt install zrok2-agent

   Fedora, Rocky

   sudo dnf install zrok2-agent

Enable your Account

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

zrok2 enable <your_account_token>

Start the Service

systemctl --user enable --now zrok2-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 zrok2-agent.service