After you executed the one-line installation command and you still see “Waiting for agent heartbeat..“ under the installation command.

If you installed BitNinja on the server but you are still on the same page please check the box under the installation command. If you see this then the installation was successful. Please click on the servers menu at the top left or click on the JUMP TO SEVER LIST button. The new server should appear there.

Is BitNinja running?

First, we need to check whether BitNinja is running on the server, you can do that with the service bitninja status command.

BitNinja is running on the server, but the BitNinja agent is not detected

Check if the ports below are open on your server/firewall

ProtocolPortBitNinja module(s)
TCP60412CaptchaHttp, CaptchaSmtp
TCP60413,60418*CaptchaHttps
TCP25CaptchaSmtp
TCP60201CaptchaSmtp
TCP60210CaptchaFtp (active)
TCP60211-60250CaptchaFtp (passive)
TCP60300, 60414WAF HTTP
TCP60301WAF HTTPS
TCP60414, 60415SslTerminating
TCP60416TrustedProxy HTTP
TCP60417TrustedProxy HTTPS

If these ports are closed please open the ports. The agent’s heartbeat should be detected within a few minutes.

BitNinja is not running on the server

Use service bitninja start command and the BitNinja agent’s heartbeat should be registered in a few minutes

If the agent started but the agent’s heartbeat is still not detected please refer to the previous point.
“BitNinja is running on the server, but the BitNinja agent is not detected“