DirectAdmin: Managing directadmin.conf, Changing Hostname, Adjusting Return Path, Disk Usage Suspension, and Selecting the Correct Quota Partition

This article provides a comprehensive overview of DirectAdmin configuration. It explains how to manage the main configuration file (directadmin.conf), use da config-set for safe updates, change the server hostname, customize the Return Path for diradmin emails, enable user suspension based on disk usage, and choose the correct quota partition for accurate disk reporting.

Correct Quota PartitionManaging directadmin.conf

~3 min read · Updated Mar 1, 2026

1. General DirectAdmin Configuration


Most DirectAdmin configuration settings are managed from:


Admin Level → Server Management → Admin Settings

All changes made here are stored in the main configuration Error! Hyperlink reference not valid.

/usr/local/directadmin/conf/directadmin.conf

Any modification to this file requires restarting the DirectAdmin service.

---

2. Working with directadmin.conf


DirectAdmin uses internal defaults in addition to values stored in directadmin.conf. To list all active configuration options:

/usr/local/directadmin/directadmin config

Short version:

da c

To search for a specific option:

/usr/local/directadmin/directadmin config | grep letsencrypt

Adding a value to directadmin.conf overrides the internal default.

2.1 Using da config-set (Recommended)

Instead of editing directadmin.conf manually, use:


da config-set NAME VALUE

To apply the change and restart DirectAdmin automatically:


da config-set dns_ttl 1 --restart

If successful, DirectAdmin exits with code 0.

---

3. Changing the Server Hostname


Your hostname must be a valid FQDN (Fully Qualified Domain Name) and must resolve to your server’s IP address.

Correct format:

server.domain.com

The prefix (server, host, ns1, web1, etc.) is required.

3.1 Hostnames to Avoid

These can cause conflicts with email routing:

  • mail.domain.com
  • webmail.domain.com
  • ftp.domain.com
  • smtp.domain.com
  • pop.domain.com

3.2 How to Change Hostname

Go to:


Admin Level → Admin Settings → Server's Hostname

Save the new hostname and allow one minute for DirectAdmin to restart.

---

4. Changing the Return Path for diradmin Emails


By default, DirectAdmin uses:

diradmin@hostname

To override this value:


da config-set diradmin_envelope [email protected]
systemctl restart directadmin

This is useful when you want diradmin notifications to come from a specific email address.

---

5. Suspending Users Based on Disk Usage


DirectAdmin does not suspend users automatically for exceeding disk usage because:

  • System quotas already enforce hard limits
  • Suspended users cannot log in to delete files

However, DirectAdmin provides an optional feature to suspend users who exceed their disk limit.

Note: DirectAdmin counts more than just system quota usage. It includes:

  • MySQL databases
  • Webmail data
  • Email accounts

Therefore, usage may exceed 100% even when system quotas do not.

---

6. Selecting the Correct Quota Partition


DirectAdmin relies on system quotas to calculate disk usage. Choosing the correct quota_partition is essential for accurate reporting.

6.1 Common Scenarios

A) /home is a directory inside /

If there is no separate /home partition:

quota_partition=/

B) /home is a symlink to /usr/home

Check with:

ls -la /home

If you see:

/home -> /usr/home

Then:

quota_partition=/usr

C) /home is a dedicated partition

Use:

quota_partition=/home

6.2 Listing All Partitions

df -hT

If you need to track quotas across multiple partitions, refer to:

DirectAdmin Feature 611

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