Grant Access to WHMCS Support

If you have submitted a ticket to WHMCS Technical Support, you may need to grant access for our team to investigate issues on your system. Share the connection details that match your environment, and allow traffic from the WHMCS Support IP addresses and ranges below.

This troubleshooting information only applies to self-hosted WHMCS installations.

Grant Access to WHMCS Support

To grant access to your system to WHMCS Support:

  1. Identify the WHMCS instance and account.
  2. Create a temporary WHMCS admin user.
  3. Allow access to the WHMCS Support IP addresses.
  4. Ensure file system or control panel access.
  5. Optionally, provide SSH key-authenticated access.
  6. Remove temporary access.

1. Identify the WHMCS instance and account.

Identify the WHMCS instance and the account that contains the WHMCS files before you begin granting access.

If you have multiple WHMCS installations on your server, make certain that you provide access to the correct WHMCS installation.

2. Create a temporary WHMCS admin user.

To create a temporary WHMCS admin user:

  1. Go to Configuration () > Manage Admins.
  2. Click Add New Administrator.
  3. Select Full Administrator for Administrator Role.
  4. Choose Set Credentials Manually.
  5. Enter a password.
  6. If the issue relates to the support system, check the relevant support departments.
  7. Select English for Language.
  8. Click Create Admin.
  • Do not provide root credentials to WHMCS Support under any circumstances. WHMCS Support only requires the minimum level of access necessary to troubleshoot the issue.
  • Create a new admin user for WHMCS Support for the duration of each support ticket.
  • Do not provide a username that begins with root. This value will cause a validation error when you attempt to add credentials to the support ticket.

3. Allow WHMCS IP addresses.

Allow access to the following IP addresses and ranges on all ports:

  • 184.94.197.2
  • 195.214.233.0/24
  • 208.74.120.226
  • 208.74.123.98
  • 2001:678:744::/64
  • 2620:0:28a4:40a0:be24:11ff:feca:dd57
If you use a firewall, security plugin, or security module, you may need to add the above IP addresses and ranges to your firewall rules or add them to the allowlist in your security settings.

4. Ensure file system or control panel access.

WHMCS Support requires the ability to read and write to the WHMCS files through one of the following access types:

  • User-level control panel access.
  • File system access to the web user.
  • SSH access jailed to the web user.

5. Optionally, provide SSH key-authenticated access.

If you are able to provide SSH access to the server that contains the WHMCS instance, you can use the WHMCS Support setup script to grant temporary access for our team. This is the preferred method for providing access to investigate issues.

cPanel

To allow support access to a cPanel & WHM server, you can either provide access to a cPanel-level user or use the WHMCS Support setup script to grant temporary access for our team.

cPanel User Access

For cPanel & WHM servers, provide access to a cPanel-level user that includes the Terminal feature for the account that contains the WHMCS instance.

cPanel Support Setup Script
If you do not have root access to the server, ask your server admin or hosting provider to complete these steps.

To use the WHMCS Support setup script on cPanel & WHM:

  1. Grant Normal Shell access for the cPanel account on your server that contains the WHMCS instance.
  2. Connect to your server’s SSH terminal as the root user.
  3. Run the following command:
sh <(curl https://raw.githubusercontent.com/whmcs/whmcs-support/main/ssh_keys/script.sh || wget -O - https://raw.githubusercontent.com/whmcs/whmcs-support/main/ssh_keys/script.sh)
  1. When the script prompts you, enter cpanel and press Enter.
  2. Enter the username of the account on your server that contains the WHMCS instance and press Enter.

Plesk

To allow support access to a Plesk server, you can either provide access to a Plesk Customer-level user or use the WHMCS Support setup script to grant temporary access for our team.

Plesk User Access

For Plesk servers, provide Customer-level access for the subscription that contains the WHMCS instance.

Plesk Support Setup Script
If you do not have root access to the server, ask your server admin or hosting provider to complete these steps.

To use the WHMCS Support setup script on Plesk:

  1. Set the SSH access type to /bin/sh or /bin/bash for the Plesk subscription that contains the WHMCS instance.
  2. Connect to your server’s SSH terminal as the root user.
  3. Run the following command:
sh <(curl https://raw.githubusercontent.com/whmcs/whmcs-support/main/ssh_keys/script.sh || wget -O - https://raw.githubusercontent.com/whmcs/whmcs-support/main/ssh_keys/script.sh)
  1. When the script prompts you, enter plesk and press Enter.
  2. Enter the system user for the hosting subscription on your server that contains the WHMCS instance and press Enter.

Other Server Types

If your server uses a different control panel or no control panel, you must add the SSH key manually:

  1. Download the WHMCS Support SSH public key.
  2. Add the SSH key to your server to provide user-level access.
For more information on how to complete these steps, see your control panel or operating system’s documentation.

6. Remove temporary access.

After we have resolved your support request, remove the temporary WHMCS support access from your system:

  1. Remove the [email protected] SSH key. If you used the WHMCS Support setup script, run the following command to remove the key:

    sed -i '/[email protected]/d' ~/.ssh/authorized_keys

  2. Remove any temporary firewall rules or allowlist entries that you added.

  3. Remove the temporary WHMCS admin user that you created for the ticket.

Do not leave temporary access available after we resolve your support ticket. Unnecessary access to your server could cause a security risk.
whmcs-support ip-addresses security troubleshooting

Last modified: 2026 May 5