System Requirements
Before installing the PatchCTL agent, ensure your servers meet the following requirements.
Supported Operating Systems
PatchCTL supports major enterprise Linux distributions:
| Distribution | Versions | Package Manager |
|---|---|---|
| Ubuntu | 20.04, 22.04, 24.04 | apt |
| Debian | 11, 12 | apt |
| RHEL | 8, 9 | dnf |
| Rocky Linux | 8, 9 | dnf |
| CentOS Stream | 8, 9 | dnf |
| Fedora | 38, 39, 40 | dnf |
| openSUSE Leap | 15.4, 15.5, 15.6 | zypper |
| SUSE Enterprise | 15 SP4+ | zypper |
Currently, only x86_64 (amd64) architecture is supported. ARM support is planned for a future release.
Hardware Requirements
The PatchCTL agent is designed to be lightweight:
| Resource | Minimum | Recommended |
|---|---|---|
| CPU | Any x86_64 | - |
| RAM | 64 MB available | 128 MB available |
| Disk | 50 MB free | 100 MB free |
Software Requirements
Required
- systemd - Used for service management (standard on all supported distros)
- curl - Required for installation script
- Root or sudo access - Agent installation requires elevated privileges
Optional
- ca-certificates - Usually pre-installed; required for HTTPS connections
Network Requirements
Outbound Connectivity
The agent requires outbound HTTPS access to:
| Endpoint | Port | Purpose |
|---|---|---|
api.patchctl.com | 443 | API communication |
downloads.patchctl.com | 443 | Agent binary downloads |
Only outbound HTTPS (port 443) is required. The agent never accepts inbound connections.
Proxy Support
If your servers access the internet through a proxy, set the standard environment variables:
export HTTPS_PROXY=http://proxy.example.com:8080
export NO_PROXY=localhost,127.0.0.1
For permanent configuration, add these to /etc/environment or the agent's systemd service file.
Browser Requirements
The PatchCTL dashboard supports modern browsers:
| Browser | Minimum Version |
|---|---|
| Chrome | 90+ |
| Firefox | 90+ |
| Safari | 14+ |
| Edge | 90+ |
License Requirements
Each server running the PatchCTL agent counts as one node against your license:
| Plan | Included Nodes |
|---|---|
| Free | 5 |
| Professional | 50 |
| Enterprise | Unlimited |
See Billing & Plans for pricing details.
Next Steps
Once you've verified your servers meet these requirements, proceed to the Quick Start Guide.