Agent Repository

Latest agent version: 3.4.1 released 2026-11-08

Check it from a script with curl -s https://get.netwarden.com/VERSION, or read latest.json for every artifact with its SHA-256.

Quick Installation

Install the Netwarden agent with a single command (automatically configures the repository):

curl -fsSL https://get.netwarden.com/install.sh | sudo bash -s -- --tenant-id YOUR_TENANT_ID --api-key YOUR_API_KEY

Get your credentials from https://app.netwarden.com/settings

Note: The -s -- is required when piping to bash to pass arguments to the script.

FreeBSD and OPNsense

As root (FreeBSD 14 or 15, OPNsense 25.x or 26.x; amd64 or arm64). Uses only base-system tools:

fetch -o - https://get.netwarden.com/install-freebsd.sh | sh -s -- --tenant-id YOUR_TENANT_ID --api-key YOUR_API_KEY

Or install a package directly with pkg add https://get.netwarden.com/netwarden-latest-freebsd15-amd64.pkg (replace 15 with 14 and amd64 with arm64 as needed), then add your credentials to /usr/local/etc/netwarden/netwarden.conf.

Direct Package Installation

RedHat/CentOS/Fedora/Rocky/Alma

Install the latest RPM package (includes repository configuration):

# For x86_64 systems
sudo rpm -ivh https://get.netwarden.com/netwarden-latest.x86_64.rpm

# For ARM64 systems
sudo rpm -ivh https://get.netwarden.com/netwarden-latest.aarch64.rpm

# For ARMv7 systems
sudo rpm -ivh https://get.netwarden.com/netwarden-latest.armv7hl.rpm

Debian/Ubuntu

Install the latest DEB package (includes repository configuration):

# For x86_64/amd64 systems
wget https://get.netwarden.com/netwarden-latest.amd64.deb
sudo dpkg -i netwarden-latest.amd64.deb
sudo apt-get install -f  # Fix any dependency issues

# For ARM64 systems
wget https://get.netwarden.com/netwarden-latest.arm64.deb
sudo dpkg -i netwarden-latest.arm64.deb
sudo apt-get install -f  # Fix any dependency issues

# For ARMv7/armhf systems
wget https://get.netwarden.com/netwarden-latest.armhf.deb
sudo dpkg -i netwarden-latest.armhf.deb
sudo apt-get install -f  # Fix any dependency issues

Windows

Windows Installer (recommended - includes service setup):

Standalone ZIP packages:

macOS

Install using the packaged tarballs (includes installation script):

# For Apple Silicon (M1/M2/M3/M4) Macs
curl -LO https://get.netwarden.com/netwarden-latest-macos-arm64.tar.gz
tar -xzf netwarden-latest-macos-arm64.tar.gz
cd netwarden-*-macos-arm64
sudo ./scripts/install.sh

# For Intel Macs
curl -LO https://get.netwarden.com/netwarden-latest-macos-intel.tar.gz
tar -xzf netwarden-latest-macos-intel.tar.gz
cd netwarden-*-macos-intel
sudo ./scripts/install.sh

Synology DSM

Install on Synology NAS running DSM 7.0 or later:

Compatible x86_64 models: DS220+, DS720+, DS920+, DS1621+, and other Intel/AMD Synology NAS models

Compatible ARM64 models: DS223, DS223j, DS423, DS124, DS220j, and other ARM-based Synology NAS models

Installation:

  1. Open Package Center on your Synology DSM
  2. Click "Manual Install"
  3. Upload the downloaded .spk file
  4. Follow the wizard to enter your Tenant ID and API Key
  5. The agent will start automatically after installation

Post-Installation Configuration

If you installed the package directly, configure your credentials:

# Linux systems
sudo nano /etc/netwarden/netwarden.conf

# macOS systems
sudo nano /usr/local/etc/netwarden/netwarden.conf

Set your tenant_id (10-character string) and api_key (starts with nw_sk_), then restart the service:

# Linux systems (systemd)
sudo systemctl restart netwarden

# macOS systems (launchd)
sudo launchctl stop com.netwarden.agent
sudo launchctl start com.netwarden.agent

Self-Hosted Deployments

If running your own Netwarden server, add these options to netwarden.conf:

# Point the agent at your self-hosted server
server_url: https://your-server.example.com

# For self-signed certificates, provide your CA certificate
tls_ca_cert: /path/to/ca.pem

# Or skip TLS verification (development/testing only)
tls_skip_verify: true

Updating the Agent

Once installed, the agent can be updated using your system's package manager:

# RedHat-based systems
sudo dnf update netwarden

# Debian-based systems
sudo apt update && sudo apt upgrade netwarden

Browse Repository

Documentation

For detailed documentation, troubleshooting, and API references:

Requirements