Agent Installation

For the admin who know what they need, and needs a fast way to get it, you can use this command to setup and install knocknoc-agent very quickly.

Browse to https://YourKnocknoc.url/admin and login with the knocknoc-admin user.
Click on Agents and Create Agent.
Enter a sensible name eg [AgentServerHostname].
Copy the token that is produced.
Login to the server hosting the agent via the command line and become the root user.
Run this command it will configure apt, setup secure repository access, and install knocknoc agent.
curl -sSL https://packages.knocknoc.io/setup/setup_knocknoc_agent.sh | bash
Accept the License Agreement.
Enter the URL and Port of your Knocknoc server.
Paste the Agent Token from earlier.
Confirm if you have a valid SSL certificate on your Knocknoc server
You can now start adding Backends and ACLs.

To get knocknoc-agent working through a web proxy; you can add the proxy environment variable to the systemd unit file.

Edit the systemd unit file.
vi /etc/systemd/system/knocknoc-agent.service
Add this line under the [service] section
Environment="HTTPS_PROXY=http://proxyIPaddress:proxyport"
Reload the systemctl daemon
systemctl daemon-reload
Restart knocknoc-agent
systemctl restart knocknoc-agent

For other systems, download links are in the Knocknoc Licensing Portal.

Agent Requirements

The agent will prompt you to connect to the knocknoc server component during install, or you can configure it later with the config file or --configure command. This requires access to the knocknoc server hostname on port 443/TCP, using HTTPS (Secure Websockets). Often the knocknoc server is on the internet somewhere, and the agent connects out to it to receives commands.

The agent is currently supported on the following platforms:

Debian 11, Buster and Debian 12, Bookworm
Ubuntu 22.04, Jammy and Ubuntu 20.04, Focal
Redhat El7+
Centos 7+
Other redhat deritives, like Rocky, Oracle Linux etc
Microsoft Windows
Debian ARM64 (eg raspberry pi)
Docker on amd64 linux