Packaged Installer Requirements
The packaged installer deploys the Detectify Internal Scanner as a single script on a Linux host. No Kubernetes knowledge is required — the script handles everything automatically, including provisioning a lightweight k3s cluster.
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| OS | Ubuntu 22.04+ or Debian 12+ (x86_64) | Ubuntu 24.04 |
| Architecture | x86_64 / amd64 | x86_64 / amd64 |
| RAM | 4 GB | 8 GB |
| Disk | 20 GB free | 50 GB free |
| Init system | systemd | systemd |
The installer runs a pre-flight check that verifies all requirements before making any changes to your system.
Network
Outbound Access
The scanner needs outbound HTTPS (port 443) access to:
| Destination | Purpose |
|---|---|
registry.detectify.com | Pull container images |
license.detectify.com | License validation |
connector.detectify.com | Job polling and results reporting |
No inbound ports need to be opened. The scanner communicates outbound only.
Firewall
If your host runs a firewall (firewalld, ufw, or nftables), the installer will detect it and warn you. Ensure outbound HTTPS traffic to the destinations above is allowed.
Software
The host needs curl or wget installed. No other dependencies are required — the installer provisions everything else.
Detectify Credentials
You need four credentials to complete the installation:
| Credential | Description |
|---|---|
| License Key | Unique identifier for your scanner instance |
| Connector API Key | Authentication token for the Detectify platform |
| Registry Username | Docker registry username for pulling scanner images |
| Registry Password | Docker registry password for pulling scanner images |
Don’t have credentials? Contact your Detectify account team or reach out to us to enable Internal Scanning.
Next Steps
- Install the scanner — Step-by-step installation guide