> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 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](https://whoami.crowncloud.net/) or [IP-API](https://ip-api.com/). 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:

```bash
/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:

```bash
/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.

```bash
/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.
<img alt="CrownPanel login" src={image0} />
### Connect with VNC
Use the VNC feature to connect to your server.
<img alt="VNC option in CrownPanel" src={image1} />
<img alt="VNC console" src={image2} />
### 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:
```bash
/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](https://crowncloud.net/clients/submitticket.php) for assistance.
