Installation
Download and install the Kudu Linux Agent on Ubuntu, Debian, Fedora, or Arch Linux servers for headless system maintenance and cloud-connected monitoring.
Quick Install (recommended)
The easiest way to install the Linux Agent is with the one-line installer script. It automatically downloads the latest release, installs it, configures your API key, and sets up a systemd service.
curl -fsSL https://raw.githubusercontent.com/adventdevinc/kudu/main/scripts/install.sh | sudo bash -s -- --api-key YOUR_KEYThe installer:
- Queries GitHub for the latest release and downloads the correct AppImage
- Installs to
/opt/kudu/Kudu.AppImagewith a symlink at/usr/local/bin/kudu - Configures your API key (and optional
--server-url) - Creates and enables a
kudu-daemonsystemd service - Sets the
APPIMAGEenv var in the service so auto-updates work
Optional flags:
| Flag | Effect |
|---|---|
--no-daemon | Don't start the daemon immediately after install |
--no-boot | Skip creating the systemd service |
--server-url URL | Connect to a custom server URL |
Manual Install
If you prefer to install manually, the Linux Agent is available as an AppImage (any distro) or a .deb package (Debian/Ubuntu). Download the latest release from the GitHub releases page.
Always check the releases page for the latest version. The URLs below use v2.4.7 as an example — replace the version number with the latest release.
AppImage (any distro)
curl -L -o kudu https://github.com/adventdevinc/kudu/releases/download/v2.4.7/Kudu-2.4.7-x86_64.AppImage
chmod +x kudu
sudo mv kudu /usr/local/bin/kuduDebian / Ubuntu (.deb)
curl -L -O https://github.com/adventdevinc/kudu/releases/download/v2.4.7/Kudu-2.4.7-amd64.deb
sudo dpkg -i Kudu-2.4.7-amd64.debRequirements
| Requirement | Details |
|---|---|
| Architecture | x86_64 |
| Kernel | Linux 4.15+ |
| Dependencies | None (AppImage is self-contained) |
| Network | Outbound HTTPS for Cloud connectivity |
| Privileges | Root recommended for full system access |
Updating
To update, download the latest release from the GitHub releases page and replace the existing binary. For AppImage installs:
curl -L -o /tmp/kudu https://github.com/adventdevinc/kudu/releases/download/vX.Y.Z/Kudu-X.Y.Z-x86_64.AppImage
chmod +x /tmp/kudu
sudo mv /tmp/kudu /usr/local/bin/kudu
sudo systemctl restart kuduFor .deb installs, download the new .deb and run sudo dpkg -i again — it will upgrade in place.
Linux Agent for Headless Servers
Run Kudu as a headless systemd daemon on Linux servers for continuous system maintenance, remote command execution, and cloud-connected monitoring.
Usage
Configure and run the Kudu Linux Agent as a systemd service. Set up API keys, manage scan schedules, and connect to Kudu Cloud for remote management.