Revision as of 17:31, 4 August 2020

Supported Features

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

Adding a DirectAdmin Server

1. Navigate to Configuration () > System Settings > Servers or, prior to WHMCS 8.0, Setup > Servers > Add New Server.
2. Select Directadmin from the 'Type' dropdown menu
3. Fill in the fields on the rest of the page details. The username and password should be for a reseller user on your server to which your hosting packages belong.
4. The default port will be displayed. If your server is configured to communicate on a different port, tick the Override with Custom Port checkbox and enter it into the Port field. For more information refer to Server Port Overrides.

Setting up your DirectAdmin Packages

For account creation to work successfully with DirectAdmin, you must have your packages setup in your DirectAdmin control panel. Here is how to setup hosting products in WHMCS to work with your DirectAdmin server.

1. Setup the Hosting Package in WHMCS as normal (Setup > Products/Services > Add New Product/Service) entering a name, description, pricing and choosing the server type "Directadmin"
2. Next, log into your Direct Admin Server. Once logged in, click Manage User Packages.
3. You will then see a list of all your available packages. If you already have the package you are setting up in WHMCS setup in DirectAdmin then you can just copy the name from the list. If not, you will need to create it. Once the package is added, remember the package name shown in the Package column.
4. Once you have this name, then go back to your WHMCS Admin Area and on the Module Settings tab of the Product Setup enter this Package Name exactly as it appears on the list in DirectAdmin above.

API Token Permissions

With API Tokens for DirectAdmin, it is possible to restrict what actions an API Token can perform. For WHMCS to be able to perform all the operations it supports, the following permissions are required:

Common Problems

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 on the Setup > Products/Services > Servers > Edit page. 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. Ticking the secure checkbox on the server configuration page will resolve this error (Setup > Products/Services > Servers > Edit).