For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /general/pbx_management/whitelist_ipaddress_on_pbx.md.

How to Whitelist Your IP Address on Incredible PBX

This guide walks you through whitelisting your IP address on the Incredible PBX server. Whitelisting gives you access to the server when your IP address has changed or when you add new users. If you cannot connect to the server because of IP restrictions, you can use VNC for recovery.

Warning

Make sure all whitelisted IP addresses and FQDNs are correct, to keep access to your PBX server secure.

Find Your Public IP Address

To find your public IP address, visit Whoami or IP-API. Either page displays your public IP address.

Info

Check your public IP address regularly. If it changes, you need to update the whitelist to keep uninterrupted access.

Common situations where you need to whitelist an IP address:

  • You have lost access to the PBX server, and the web panel no longer loads.
  • Your home or office IP address has changed.
  • You need to add a new user to the PBX server.

Whitelist an IP Address

Use the following command to whitelist an IP address:

/root/add-ip username IP_Address

Where:

  • username is the name of the new user.
  • IP_Address is the new IP address to add.

Whitelist a Second User's IP Address

To whitelist additional IP addresses, run the same command with the matching username and IP address:

/root/add-ip second_user 192.168.44.22

Replace second_user with the actual username and 192.168.44.22 with the actual IP address.

Whitelist an FQDN (Optional)

The add-fqdn command whitelists a fully qualified domain name (FQDN) in the firewall. Incredible PBX blocks traffic from IP addresses that are not whitelisted, so you can use this command to authorize an external user.

The advantage of an FQDN is that you can use a dynamic DNS service to update the IP address behind the name automatically. That keeps you connected when your IP address changes.

/root/add-fqdn username myserver.no-ip.net

Where:

  • username is the name of the new user.
  • myserver.no-ip.net is your actual FQDN.

Recover Access if You Are Locked Out

If you are locked out of the server because of IP restrictions or other access problems, you can regain access using the VNC feature in CrownPanel.

Log in to CrownPanel

Log in to CrownPanel.

CrownPanel login

Connect with VNC

Use the VNC feature to connect to your server.

VNC option in CrownPanel

VNC console

Log in to the server

Once connected, log in with your server credentials. If you changed the root password during installation, use the updated root password when you access the server via VNC, to make sure you have full access.

Check your current IP address

Once you have logged in, verify your current public IP address.

Whitelist the new IP address

If your IP address has changed, whitelist the new address straight away to restore access and avoid further connection problems. For example:

/root/add-ip admin your_public_ip

Replace admin with the actual username and your_public_ip with your actual public IP address.

Troubleshooting and Support

If you run into any problems, open a Support Ticket for assistance.