Agent Installation
The PatchCTL agent can be installed on any supported Linux distribution using our automated installer or manual installation.
Automated Installation (Recommended)
The quickest way to install the agent:
curl -fsSL https://downloads.patchctl.com/install.sh | sudo bash -s -- --key=YOUR_LICENSE_KEY
The installer automatically:
- Detects your distribution and version
- Downloads the appropriate binary
- Configures the agent with your license key
- Sets up the systemd service
- Starts the agent
Distribution-Specific Guides
For detailed instructions tailored to your OS:
- Ubuntu & Debian - apt-based distributions
- RHEL & Rocky - dnf/yum-based distributions
- SUSE & openSUSE - zypper-based distributions
- Air-gapped Environments - Offline installation
Binary Variants
Different binaries are built for glibc compatibility:
| Binary | Target Distributions | GLIBC |
|---|---|---|
patchctl-agent-linux-amd64 | Ubuntu, Debian | 2.35+ |
patchctl-agent-linux-amd64-rhel | RHEL, Rocky, CentOS, Fedora | 2.28+ |
patchctl-agent-linux-amd64-suse | SUSE, openSUSE | 2.31+ |
The installer automatically selects the correct binary for your system.
Installation Requirements
Before installing, ensure:
- Root or sudo access
-
curlinstalled (for automated install) - Outbound HTTPS access to
api.patchctl.com - Valid license key from the dashboard
Post-Installation Verification
After installation, verify the agent is running:
# Check service status
sudo systemctl status patchctl
# View recent logs
sudo journalctl -u patchctl --since "5 minutes ago"
# Check configuration
cat /etc/patchctl/config.json
Your server should appear in the dashboard within 5 minutes.
Next Steps
After installation: