LogoفارسیFA

Troubleshooting the DirectAdmin Service – Complete Diagnostic Guide for Common DA Issues

When the DirectAdmin panel becomes inaccessible, fails to load, or shows unexpected errors, a structured troubleshooting approach helps identify and resolve the issue quickly. This guide covers debugging DirectAdmin, diagnosing port 2222 issues, login failures, installation errors, permission problems, and granting secure access to DirectAdmin support.

DirectAdmin ServiceDiagnostic

~3 min read · Updated Mar 1, 2026

1. Running DirectAdmin in Debug Mode


The standard error log (/var/log/directadmin/error.log) only shows critical errors. To see detailed internal activity, run DirectAdmin in debug mode.

Steps:


systemctl stop directadmin
da server --debug=2000

Now, every browser/API request will print detailed output in the terminal.

Filter output (example: POST data only):


da server --debug=2000 | grep --line-buffered "POST"

Save debug output to a Error! Hyperlink reference not valid. 

da server --debug=2000 > /var/log/directadmin/debug.log

Exit debug mode and restart normally:


Ctrl+C
systemctl start directadmin

Common debug levels:

  • 2000 → maximum detail
  • 800 / 400 → medium detail
---

2. Issue: Cannot Connect to Port 2222


If http://IP:2222 does not load, follow this checklist:

Check if the service is running:


systemctl status directadmin
ps auxwwwf | grep directadmin

If the service is stopped, check logs:


tail -n 100 /var/log/directadmin/error.log

Common causes:

  • Incorrect ethernet_dev in directadmin.conf
  • Invalid license (wrong IP or Client ID)
  • Your IP is blacklisted in data/admin/ip_blacklist
  • Wrong OS binary downloaded
---

Check if port 2222 is open:


telnet 127.0.0.1 2222

If it works locally but not externally → firewall issue.

Fix firewall:

firewalld (CentOS 7+):


firewall-cmd --zone=public --add-port=2222/tcp --permanent
firewall-cmd --reload

iptables:


iptables -I INPUT -p tcp --dport 2222 -j ACCEPT

Debug manually:


systemctl stop directadmin
da server --debug=200
---

3. Issue: Cannot Log In as admin


Common causes:

1. Disk full (sessions cannot be created)


df -h /usr /var /home

2. Your IP changes frequently (mobile/Starlink)

Disable IP check:


da config-set disable_ip_check 1 --restart

3. Wrong password


passwd admin

4. Incorrect server time


date
timedatectl

5. Your IP is blacklisted


cat /usr/local/directadmin/data/admin/ip_blacklist

Remove your IP:


nano /usr/local/directadmin/data/admin/ip_blacklist

Whitelist your IP:


echo "YOUR_IP" >> /usr/local/directadmin/data/admin/ip_whitelist
---

4. Installation Error: “Cannot find the DirectAdmin binary. Extraction failed”


Common causes:

  • Corrupted download → re-download installer
  • SSL certificate issues → use --no-check-certificate
  • Invalid license or wrong IP → contact support
  • Wrong OS selected in client area → reinstall with correct OS
---

5. Error: “The request cannot be executed because it does not exist in your authority level”


This means your current login level (User/Reseller/Admin) is not allowed to run the command.

Checklist:

  • Ensure you are logged in as the correct account
  • Refresh session (multiple tabs cause conflicts)
  • Check commands.allow, commands.deny, never_commands
  • Check Feature Set assigned to the account

Deep debugging:


systemctl stop directadmin
da server --debug=703

Look for isAllowedToExecute or deny_override in output.

---

6. Granting Root Access to DirectAdmin Support


If DirectAdmin support requests root access:

Whitelist their IP:

Support IP: 49.12.185.180

CSF:


csf -a 49.12.185.180

firewalld:


firewall-cmd --permanent --add-source=49.12.185.180
firewall-cmd --reload

iptables:


iptables -A INPUT -s 49.12.185.180 -j ACCEPT

Add their SSH key (recommended):


curl -s https://directadmin.com/authorized_keys >> /root/.ssh/authorized_keys

Written & researched by Dr. Shahin Siami

Related Articles

Email Client Configuration & Dovecot Quota/Monitoring Guide for DirectAdmin Users

This guide explains how to configure popular email clients (iPhone Mail, Thunderbird, Gmail POP/SMTP), enable Dovecot LMTP quota warnings, and check the last login time for all email accounts on a DirectAdmin server. It includes step by step instructions, recommended IMAP/SMTP settings, and useful administrative scripts.

Continue

Troubleshooting Dovecot in DirectAdmin – Fixing IMAP Errors, Authentication Issues, and SSL Certificate Checks

Dovecot is the IMAP/POP3 server used by DirectAdmin. Sometimes users encounter errors such as “Connection dropped by IMAP server” or “unknown user” during authentication. This guide explains how to fix corrupted Dovecot indexes, understand authentication logs, hide unnecessary warnings, and manually inspect SSL certificates on IMAP ports 143 and 993.

Continue

DNS Troubleshooting in DirectAdmin – When named is Running but Domains Do Not Resolve

Sometimes the named (BIND) service runs normally, yet DNS queries fail or domains do not resolve from outside. This guide provides a complete troubleshooting workflow for checking named listeners, firewall rules, named.conf configuration, DNS propagation issues, subdomain problems, resolv.conf errors, and common Apache/Nginx misconfigurations.

Continue

Managing DNS Records in DirectAdmin – Complete Practical Guide for Administrators

DirectAdmin provides a powerful DNS management system that allows administrators to control TTL values, create SRV records, enable DNSSEC, manage subdomain delegation, automate TLSA records, and perform mass DNS updates. This guide explains all essential DNS operations in DirectAdmin with real-world examples and best practices.

Continue

DNS and Nameservers in DirectAdmin – Complete, Practical, and Professional Guide

DNS is the backbone of the internet, responsible for translating domain names into IP addresses. DirectAdmin allows you to create private nameservers (ns1/ns2), manage DNS zones, configure DNS clustering, use external DNS, and troubleshoot common issues. This guide provides a complete, clear, and practical explanation of DNS concepts and their implementation in DirectAdmin.

Continue

CustomBuild in DirectAdmin – Complete Guide to Installation, Updates, Configuration, and Advanced Customization

CustomBuild is DirectAdmin’s primary software management system. It installs, updates, configures, and rebuilds essential services such as Apache, Nginx, PHP, MariaDB/MySQL, Exim, Dovecot, FTP servers, and more. Because most components are compiled from source, CustomBuild offers exceptional flexibility, fast access to new versions, and optimized performance.

Continue
Previous ArticleNext Article