DirectAdmin

From WHMCS Documentation

About this Module

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

Supported Features

Create Suspend Unsuspend Terminate
Yes Yes Yes Yes
Change Package Change Password Usage Updates Client Area Link
Yes Yes Yes Yes

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 DirectAdmin 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:

CMD_API_PACKAGES_RESELLER CMD_API_PACKAGES_USER CMD_API_ADDITIONAL_DOMAINS
CMD_API_SHOW_ALL_USERS CMD_API_SHOW_USERS CMD_API_SHOW_RESELLERS
CMD_API_DNS_CONTROL CMD_API_DNS_MX CMD_API_FTP
CMD_API_SHOW_USER_CONFIG CMD_API_SYSTEM_INFO CMD_API_SHOW_RESELLER_IPS
CMD_API_ACCOUNT_USER CMD_SELECT_USERS CMD_API_USER_PASSWD
CMD_API_MODIFY_RESELLER CMD_API_MODIFY_USER CMD_API_SHOW_USER_USAGE
CMD_API_RESELLER_STATS

The server sync tool requires the CMD_API_SHOW_RESELLERS permission. Without this permission, the system can still perform other actions.

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.

Server Modules
cPanel/WHM - DirectAdmin - Plesk - Helm 3 - Helm 4 - Ensim - InterWorx - WebsitePanel - Cloudmin
Lxadmin - Virtualmin Pro - XPanel - HyperVM - SolusVM - Cloudmin - WHMSonic - VPS.Net
CentovaCast - SCPanel - MediaCP - GameCP - TCAdmin - Reseller Central - Auto Release - Heart Internet

Registrar Modules
Enom - ResellerClub - Nominet - OpenSRS - ResellOne - OnlineNIC - PlanetDomain - Affordable Domains
TPP Wholesale - TPPInternet - Stargate - Namecheap - NetEarthOne - Bizcn - InternetBS - GMO Internet
12Register - Registercom - DotDNS - WebNIC - Dot.TK - HexoNet - Realtime Register - Registereu
RRPProxy - ResellerCamp - TransIP - Heart Internet - IPMirror - NetRegistry - OVH - VentraIP Wholesale
Email - 101Domain

Fraud Modules
MaxMind - VariLogiX FraudCall - Telesign

Gateway Modules
2CheckOut - AsiaPay - Auth.net Echeck - Authorize.net - Authorize.net CIM - Bank Transfer - BidPay
BluePay - BluePay Echeck - BluePay Remote - Boleto - CashU - CC Avenue - ChronoPay - Direct Debit
EMatters - E-Path - eProcessingNetwork - eWAY Tokens - F2B - Finansbank - GarantiBank - Gate2Shop
Inpay - InternetSecure - IP.Pay - Kuveytturk - Modulo Moip - Mail In Payment - Merchant Partners
Merchant Warrior - IDEALMollie - Moneris - Moneris Vault - Skrill 1-Tap - NaviGate - NETbilling
Netregistry Pay - NoChex - Offline Credit Card - Optimal Payments - PagSeguro - Payflow Pro - Pay Junction
Paymate AU and NZ - Payment Express - PayPal - PayPal Card Payments - PayPal Express Checkout
PayPal Payments - PayPal Payments Pro - PayPoint.net (SecPay) - Payson - Planet Authorize - ProtX VSP Form
PSIGate - Quantum Gateway - Quantum Vault - SagePay - SagePay Tokens v2 - SecurePay
SecurePay AU - Secure Trading - TrustCommerce - USA ePay - WorldPay - WorldPay Invisible