Server 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 server very quickly.

This is currently only supported on Debian 11 or 12, or Ubuntu 22.04

Self-Hosted Servers

1. Log into you Knocknoc Server via the command line and become the root user.
2. Run this command below and it will display the license. Please read the license and agree. The script then will configure apt, setup secure repository access, and install Knocknoc server.
   curl -sSL https://packages.knocknoc.io/setup/setup_knocknoc.sh | bash
3. Accept the License Agreement.
4. Knocknoc Server will ask the IP to listen on and the port. By default it will listen on 0.0.0.0:8756, please adjust as your firewall or reverse proxy layout requires.
5. The install will then ask for TrustedForwarders, by default 127.0.0.1/32 is entered but if the server is behind a reverse proxy, the IP pf the reverse proxy will need to be entered. TrustedForwarders are the machines permitted to send the ForwardFor header to Knocknoc.
6. Lastly the install will generate an SSL certificate and key, where it will ask you for Organizational Details. Knocknoc only communicates over HTTPS, so this certificate is to get you started, and can be replaced later.
7. Once the script is completed, you should be able to obtain the knocknoc-admin password from the logs
   cat /var/log/syslog |grep knocknoc-admin or journalctl -u knocknoc |grep knocknoc-admin
8. Accept the License Agreement.
9. Knocknoc Server will ask the IP to listen on and the port. By default it will listen on all IP's on port 8756, this is because in most instances Knocknoc will sit behind a web proxy or firewall that will redirect port 443 to Knocknoc server.
10. The install will then ask for TrustedForwarders, by default 127.0.0.1/32 is entered but if the server is behind a reverse proxy, this IP will need to be listed.
11. Lastly the install will generate an SSL certificate and key where it will ask you for Organizational Details.
12. You are now ready to log into your Knocknoc admin portal.
13. Browse to https://YourKnocknoc.url/admin and login with the knocknoc-admin user.
14. Click on Settings and paste the license key from the license portal and hit save.
15. At this point if you wish you can setup Admin Portal Authentication or proceed with Agent Installation.

Note - you need a license to use Knocknoc server, the details can be found here.