DirectAdmin Licensing – Complete Guide to License Types, Legacy Licenses, Limited Licenses, Common Errors, Manual Updates, and Troubleshooting

DirectAdmin requires a valid license to operate. This guide explains how to check your license, the difference between modern and legacy licenses, what Limited licenses are, how over limit mode works, how to fix common licensing errors, how to manually update your license key, and how to troubleshoot broken licensing systems.

License TypesLegacy Licenses

~4 min read · Updated Mar 1, 2026

1. Checking the License on a Server


You can view your DirectAdmin license information from the GUI:


Admin Level → Support & Help → Licensing

This page shows your license type, status, limits, and expiration date.

---

2. What Are Legacy Licenses and the Legacy Codebase?


Historically, DirectAdmin used a hybrid codebase:

  • Core feature set
  • Pro Pack (additional features)

As of August 1, 2023, DirectAdmin unified all modern licenses into a single codebase. The following licenses include all features:

  • Personal PLUS
  • Lite
  • Standard

All other license types are considered legacy and are no longer sold. Legacy licenses run on a separate codebase with limited maintenance.

The Licensing page will indicate if your server is using a legacy license.

Important: You can upgrade from legacy → unified codebase by applying a new license key, but downgrading is not supported.

---

3. What Is a Limited License?


A Limited license behaves like any other DirectAdmin license but includes maximum limits:

  • Account Limit – Total number of Admin, Reseller, and User accounts.
  • Domain Limit – Total number of domains and domain pointers.

Account Limit

The count includes all account types. Example: A fresh install with one Admin = 1 account.

Domain Limit

Counts all active domains and pointers. Standalone DNS zones do not count toward the limit.

---

4. What Happens When You Exceed Your Limits?


DirectAdmin enters over limit mode, disabling many features until you reduce the number of accounts or domains.

Disabled features include:

  • Domain creation
  • User creation
  • Subdomains
  • DNSSEC
  • Email actions
  • DKIM
  • SSL certificates
  • Backups & restores
  • Multi Server Setup
  • Let’s Encrypt
  • FTP actions
  • Database creation
  • File Manager actions

Only deletion actions remain available so you can return to normal mode.

---

5. License Expired – Common Errors and Solutions


All licensing errors appear in the DirectAdmin service log:


journalctl -u directadmin
---

5.1 Permanent Error: "invalid license key"

Your license key is incorrect or missing.


/usr/local/directadmin/scripts/getLicense.sh 'YOUR_LICENSE_KEY'
---

5.2 Permanent Error: "lost license session"

Your license is being used on another server.

  • Restart DirectAdmin on the correct server to reclaim the license.
  • If stolen, reset the license key in the Client Area.
---

5.3 Request failed: context deadline exceeded

The server cannot reach the licensing server.

Test connectivity:


dig +short licensing.directadmin.com
curl https://licensing.directadmin.com
---

5.4 Transient Error: "too many requests"

Multiple servers are fighting for the same license.

Wait 10 minutes and ensure only one DirectAdmin instance is running.

---

5.5 Transient Error: "license is IP restricted"

Your server’s IP is not in the allowed IP list.

Whitelist both IPv4 and IPv6 in the Client Area.

---

5.6 Transient Error: "request time is out of sync"

Your server clock is incorrect.

Enable NTP and sync the system time.

---

5.7 Other transient errors

  • license is not active
  • license is not verified
  • license is suspended
  • license is expired

Check the Client Area for license status.

---

6. Updating Your DirectAdmin License Manually


Since DirectAdmin 1.63.8, the license file is a simple text Error! Hyperlink reference not valid.


/usr/local/directadmin/conf/license.key

Replace the license key:


echo 'YOUR_LICENSE_KEY' > /usr/local/directadmin/conf/license.key
chmod 600 /usr/local/directadmin/conf/license.key
systemctl restart directadmin

Important: The license key file must not be readable by other users.

---

7. Old Servers Without Modern SSL Support


Older OS versions (e.g., CentOS 4) do not support TLS 1.2 and cannot connect to the licensing server.

DirectAdmin cannot run on systems without modern SSL/TLS support.

---

8. Troubleshooting Broken Licensing


Check the DirectAdmin log:


journalctl -u directadmin

Most issues are covered in the License Expired section above.

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