Revision as of 13:40, 14 June 2022

About this Module

The DirectAdmin module allows you to add and manage DirectAdmin servers in WHMCS.

Supported Features

The following ports should be open for outbound connections from your WHMCS server: 2222

Adding a DirectAdmin Server

To set up a DirectAdmin server in WHMCS:

1. Go to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.
2. Click Add New Server.
3. Select DirectAdmin from the menu.
4. Enter the hostname or IP address, username, password, and access hash.
   • The username and password must be for a reseller on the server.
   • You can use a Login Key instead of the reseller password. For more information, see below.
5. Click Test Connection.
6. Enter the desired additional server details.
7. Examine the displayed default port. If your server uses a different port, check Override with Custom Port and enter the correct port. For more information, see Server Port Overrides.
8. Click Save Changes.
9. If this is the only DirectAdmin server that is currently in WHMCS, click on the name and ensure that it results in an asterisk (*) next to it. This indicates that it is the default to use when any other non-specific configuration doesn't apply.

Creating a DirectAdmin Product

You can create a product that provisions accounts on your XPanel server at Configuration () > System Settings > Products/Services or, prior to WHMCS 8.0, Setup > Products/Services > Products/Services.

For account creation to work successfully with DirectAdmin, you must have your packages set up in your DirectAdmin control panel.

After you create your product, you must:

1. Log in to your Direct Admin Server.
2. Click Manage User Packages.
3. Copy the package name from the list or create the package.
4. In WHMCS, enter the package name in the product's Module Settings tab exactly as it appears in DirectAdmin.

API Token Permissions

With API tokens for DirectAdmin, you can restrict the actions an API token can perform. For these operations, WHMCS requires the following permissions:

WHMCS Connect

This module does not support WHMCS Connect.

Troubleshooting

WHMCS Host Server IP is Blacklisted

The server on which WHMCS is installed is being blocked by DirectAdmin's security measures. Usually this is caused by invalid login credentials inside WHMCS at Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers. Once the underlying cause has been resolved, remove the WHMCS server IP from /usr/local/directadmin/data/admin/ip_blacklist

56 - Recv failure: Connection reset by peer

Indicates the DirectAdmin server is requiring an SSL connection. Checking the secure checkbox on the server configuration page will resolve this error (Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Products/Services > Servers.