{"id":2565,"date":"2026-03-02T22:47:13","date_gmt":"2026-03-02T22:47:13","guid":{"rendered":"https:\/\/ssblog.eu.enginyr.ing\/?p=2565"},"modified":"2026-03-02T23:44:25","modified_gmt":"2026-03-02T23:44:25","slug":"directadmin-1-695-breaking-change-private_html-to-public_html-merge-and-what-it-means-for-your-sites","status":"publish","type":"post","link":"https:\/\/www.serverspan.com\/en\/blog\/directadmin-1-695-breaking-change-private_html-to-public_html-merge-and-what-it-means-for-your-sites\/","title":{"rendered":"DirectAdmin 1.695 Breaking Change: private_html to public_html Merge and What It Means for Your Sites"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">DirectAdmin 1.695, released on February 18, 2026, changes all web server configuration templates to use <code>public_html<\/code> as the document root for every virtual host. Before this release, HTTPS connections were served from <code>private_html<\/code>. If your server still has domains with a separate <code>private_html<\/code> directory instead of a symlink to <code>public_html<\/code>, those sites will break after the update. The fix is straightforward, but you need to act before the update hits your server or immediately after.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This article explains what changed, why it happened, which sites are affected, how to run the built-in maintenance task, and how to verify everything manually from SSH.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What DirectAdmin Actually Changed in 1.695<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">DirectAdmin ships a set of web server configuration templates that generate the actual Apache, Nginx, or OpenLiteSpeed virtual host files for every domain on the server. Before 1.695, the TLS-enabled templates pointed the document root at <code>private_html<\/code>. The non-TLS templates pointed at <code>public_html<\/code>. This meant HTTP and HTTPS could technically serve different content from different directories.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">In practice, almost nobody used this feature. The web moved to HTTPS-everywhere years ago, and serving different content over HTTP versus HTTPS creates more problems than it solves. DirectAdmin recognized this back in version 1.649 (May 2023), when they deprecated the <code>private_html<\/code> directory toggle in the Evolution skin and started creating new domains with a <code>private_html -&gt; public_html<\/code> symlink by default.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Version 1.695 finishes the job. The following template files now reference <code>public_html<\/code> instead of <code>private_html<\/code>:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code>data\/templates\/nginx_server_secure.conf<\/code><\/li>\n\n\n\n<li><code>data\/templates\/nginx_server_secure_sub.conf<\/code><\/li>\n\n\n\n<li><code>data\/templates\/openlitespeed_vhost.conf<\/code><\/li>\n\n\n\n<li><code>data\/templates\/virtual_host2_secure.conf<\/code><\/li>\n\n\n\n<li><code>data\/templates\/virtual_host2_secure_sub.conf<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">After this update, when a visitor connects to your site over HTTPS, the web server looks in <code>public_html<\/code>. If you had a separate <code>private_html<\/code> directory with your actual site files in it (not a symlink), those files are now unreachable. The visitor gets a 403 Forbidden or sees an empty directory listing, depending on your configuration.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Who Is Affected<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Most servers are not affected. Since DirectAdmin 1.52.0, new domains have been created with <code>private_html<\/code> as a symlink pointing to <code>public_html<\/code> by default. If your server was installed in the last five to six years and you never manually created separate <code>private_html<\/code> directories, you are fine.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">You are at risk if any of the following apply:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Your server was originally installed before DirectAdmin 1.52.0 and domains were never migrated to the symlink model<\/li>\n\n\n\n<li>You (or a previous admin) set <code>default_private_html_link=0<\/code> in <code>\/usr\/local\/directadmin\/conf\/directadmin.conf<\/code> at some point<\/li>\n\n\n\n<li>You migrated accounts from another server or another control panel, and the migration process created real <code>private_html<\/code> directories instead of symlinks<\/li>\n\n\n\n<li>A user manually deleted the symlink and created a directory through the Enhanced skin or SSH<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">In our experience managing DirectAdmin servers for <a href=\"https:\/\/www.serverspan.com\/en\/webhosting\">web hosting<\/a> clients, the most common scenario is old accounts that were migrated between servers years ago. The migration process preserved the original directory structure, and nobody noticed because the symlink versus directory distinction was invisible to the end user until now.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">How to Check Your Server Before Updating<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">DirectAdmin provides a built-in maintenance task specifically for this situation. It was introduced in version 1.649 and is accessible at the Admin level in the Evolution skin.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Log in to DirectAdmin as an admin user. Navigate to <strong>Admin Tools &gt; Maintenance Tasks<\/strong>. Look for the task named <strong>Ensure all domains private document roots link to public<\/strong>. Run it. The task scans every user account on the server and reports which domains still have a separate <code>private_html<\/code> directory instead of a symlink.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If the task reports zero affected domains, you can update to 1.695 without concern. If it reports affected domains, you need to resolve each one before the update.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Resolving Affected Domains<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The resolution depends on whether the <code>private_html<\/code> and <code>public_html<\/code> directories contain the same files or different files.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Scenario 1: private_html Has the Site Files, public_html Is Empty or Outdated<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This is the most common scenario on legacy accounts. The site was deployed into <code>private_html<\/code> because HTTPS was the primary access method, and <code>public_html<\/code> was either empty or contained stale files from the original setup. The fix is to move the files from <code>private_html<\/code> to <code>public_html<\/code>, remove the directory, and create the symlink.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">From SSH as root or as the domain owner:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>cd \/home\/USERNAME\/domains\/DOMAIN.COM\n\n# Back up first\ncp -a private_html private_html.bak\n\n# Move files from private_html to public_html\nrsync -av private_html\/ public_html\/\n\n# Verify the files are in public_html\nls -la public_html\/\n\n# Remove the old directory\nrm -rf private_html\n\n# Create the symlink\nln -s public_html private_html\n\n# Verify\nls -la private_html<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>ls -la<\/code> output should show <code>private_html -&gt; public_html<\/code>. If it does, the domain will serve the same content over both HTTP and HTTPS after the update.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Scenario 2: Both Directories Contain Different Content<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This is rare but possible. If someone deliberately served different content over HTTP and HTTPS, you need to decide which version to keep. In almost every case we have seen, the <code>private_html<\/code> version is the current one (since most traffic is HTTPS), and <code>public_html<\/code> is outdated.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Compare the directories:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>diff -rq \/home\/USERNAME\/domains\/DOMAIN.COM\/public_html \\\n         \/home\/USERNAME\/domains\/DOMAIN.COM\/private_html<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Review the differences. Back up both directories. Then follow the same rsync, remove, and symlink process from Scenario 1, using whichever directory contains the correct files as the source.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Scenario 3: Hundreds of Domains to Fix<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">If you manage a reseller server with many legacy accounts, fixing domains one by one is not practical. Here is a script that identifies all domains with a real <code>private_html<\/code> directory (not a symlink) and converts them. Run this as root. Read the script before executing it. Back up first.<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>#!\/bin\/bash\n# Find all private_html directories that are NOT symlinks\nfind \/home\/*\/domains\/*\/private_html -maxdepth 0 -type d 2&gt;\/dev\/null | while read dir; do\n    domain_dir=$(dirname \"$dir\")\n    public_dir=\"$domain_dir\/public_html\"\n    private_dir=\"$domain_dir\/private_html\"\n\n    echo \"Processing: $domain_dir\"\n\n    # Check if public_html exists\n    if &#91; ! -d \"$public_dir\" ]; then\n        echo \"  WARNING: No public_html found, skipping\"\n        continue\n    fi\n\n    # Sync private_html content to public_html (preserving existing public_html files)\n    rsync -a \"$private_dir\/\" \"$public_dir\/\"\n\n    # Rename private_html as backup\n    mv \"$private_dir\" \"${private_dir}.bak.$(date +%Y%m%d)\"\n\n    # Create symlink\n    ln -s public_html \"$private_dir\"\n\n    echo \"  DONE: Converted to symlink\"\ndone<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">After running the script, re-run the DirectAdmin maintenance task to confirm zero affected domains remain. If you are a <a href=\"https:\/\/www.serverspan.com\/en\/webreseller\">reseller hosting<\/a> provider managing client accounts, coordinate with your clients before removing the <code>.bak<\/code> directories so they can verify their sites function correctly.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">The Second Change You Should Not Ignore: Secure Access Group Migration<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">DirectAdmin 1.695 includes another change that gets less attention but can cause permission issues on older servers. The update automatically enables the <code>secure_access_group<\/code> option and forces the group name to <code>access<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The secure access group makes web, email, and FTP services share the UNIX group <code>access<\/code>. This has been the default for new installations since DirectAdmin 1.33.3, released in April 2009. However, servers that predate this version, or servers where an administrator changed the group name to something other than <code>access<\/code>, will be affected.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If your server uses a custom secure access group name, the 1.695 update will rename it to <code>access<\/code>. This can break file permission setups that reference the old group name in ACLs, cron jobs, or custom scripts. Check your current configuration before updating:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>grep secure_access_group \/usr\/local\/directadmin\/conf\/directadmin.conf<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">If the output shows <code>secure_access_group=access<\/code> or the option is not present (meaning the default is already in effect), you have nothing to worry about. If it shows a different group name, audit your system for any references to that group before allowing the update to proceed.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">OPcache API Access: A Quiet but Useful Fix<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The 1.695 release also updates the default OPcache configuration file (<code>custombuild\/configure\/opcache\/opcache.ini<\/code>) to stop blocking OPcache API access. In previous versions, the default config set <code>opcache.restrict_api<\/code> to a value that prevented PHP scripts from calling OPcache functions like <code>opcache_reset()<\/code> and <code>opcache_get_status()<\/code>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">This matters if you use deployment tools or WordPress plugins that flush the OPcache after code changes. Before this fix, those tools would fail silently or throw errors depending on your PHP error reporting level. If you have been manually restarting PHP-FPM after deployments because OPcache was not clearing, this update may resolve that workflow issue. For a deeper understanding of how OPcache fits into your overall caching strategy, see our guide on <a href=\"https:\/\/www.serverspan.com\/en\/blog\/full-page-cache-vs-object-cache-vs-opcode-cache-when-to-use-each\/\">full page cache vs object cache vs opcode cache<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Post-Update Verification Checklist<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">After updating to DirectAdmin 1.695, run through these checks to confirm nothing is broken:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>1. Verify the symlinks are in place.<\/strong> Run this command as root to find any remaining real <code>private_html<\/code> directories:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>find \/home\/*\/domains\/*\/private_html -maxdepth 0 -type d 2&gt;\/dev\/null | wc -l<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">The output should be <code>0<\/code>. Any number greater than zero means you still have domains that need attention.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>2. Test HTTPS on a sample of domains.<\/strong> Use <code>curl<\/code> to verify that HTTPS returns the expected content:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>curl -sI https:\/\/yourdomain.com | head -20<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Look for a <code>200 OK<\/code> status code. A <code>403 Forbidden<\/code> or <code>404 Not Found<\/code> on a site that was working before the update likely points to a <code>private_html<\/code> directory that was not migrated.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>3. Check the secure access group.<\/strong> Verify the group exists and that web-related processes are members:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>getent group access<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>4. Rewrite the web server configuration.<\/strong> If you resolved any <code>private_html<\/code> issues after the update, force DirectAdmin to regenerate all virtual host configs:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>echo \"action=rewrite&amp;value=httpd\" &gt;&gt; \/usr\/local\/directadmin\/data\/task.queue\necho \"action=rewrite&amp;value=nginx\" &gt;&gt; \/usr\/local\/directadmin\/data\/task.queue<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Wait a few seconds for the task queue to process, then verify your sites again.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>5. Check Let&#8217;s Encrypt renewals.<\/strong> A previous 1.695 build had an issue where the <code>.well-known<\/code> HTTP challenge path failed when redirected to HTTPS. A subsequent build fixed this. Ensure your DirectAdmin is on the latest 1.695 build by running <code>\/usr\/local\/directadmin\/directadmin v<\/code> and checking the exact build date.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Why DirectAdmin Made This Change Now<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The <code>private_html<\/code> directory dates back to a time when SSL certificates were expensive and most traffic was unencrypted. Serving different content over HTTP and HTTPS had a legitimate (if narrow) use case. That era ended years ago. Free certificates from Let&#8217;s Encrypt, browser warnings on non-HTTPS pages, and search engine ranking factors all pushed the web to universal TLS.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">DirectAdmin started the deprecation in version 1.649 (May 2023) by removing the <code>private_html<\/code> toggle from the Evolution skin. Version 1.650 made the symlink the default for all new domains regardless of the <code>default_private_html_link<\/code> setting in <code>directadmin.conf<\/code>. Version 1.695 completes the process by removing <code>private_html<\/code> references from the web server templates entirely.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The DirectAdmin team chose not to run a forced migration because merging directories with different content could cause data loss. Instead, they provide the maintenance task and leave the timing to server administrators. This is the right approach for a breaking change: document it clearly, provide tooling, and let the people who know the server make the call.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What ServerSpan Clients Need to Do<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">If you are on one of our <a href=\"https:\/\/www.serverspan.com\/en\/webhosting\">web hosting plans<\/a>, we have already handled this. Our shared hosting infrastructure runs DirectAdmin with the symlink model across all accounts. The 1.695 update did not break any sites because we migrated legacy accounts during a previous maintenance cycle.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you run a VPS with DirectAdmin and manage it yourself, this article gives you everything you need to check and fix your setup. If you would rather not deal with it, our <a href=\"https:\/\/www.serverspan.com\/en\/directadmin-management\">DirectAdmin management<\/a> service covers exactly this kind of update review, pre-update audit, migration, and verification included.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">For reseller accounts managing multiple clients, this is the kind of change that separates proactive providers from reactive ones. Run the maintenance task now, fix any affected domains, and communicate the change to your clients before they discover it through a broken site. If you need a hosting platform where these panel updates are handled for you, take a look at our <a href=\"https:\/\/www.serverspan.com\/en\/webreseller\">reseller hosting packages<\/a>.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After addressing the <code>private_html<\/code> merge, consider reviewing your overall site delivery pipeline. Pairing a properly configured DirectAdmin setup with Cloudflare can eliminate an entire class of performance issues. Our guide on <a href=\"https:\/\/www.serverspan.com\/en\/blog\/how-to-max-out-your-free-cloudflare-plan-the-ultimate-guide-to-rocket-speed-your-website\/\">how to optimize your free Cloudflare plan<\/a> walks through the settings that matter most. And if you are weighing DirectAdmin against other panels for your next server, our <a href=\"https:\/\/www.serverspan.com\/en\/blog\/directadmin-vs-cpanel-choosing-the-right-hosting-control-panel\/\">DirectAdmin vs cPanel comparison<\/a> breaks down the practical differences.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>DirectAdmin 1.695, released on February 18, 2026, changes all web server configuration templates to use public_html as the document root for every virtual host. Before this release, HTTPS connections were served from private_html. If your server still has domains with a separate private_html directory instead of a symlink to public_html, those sites will break after [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":2566,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[11],"tags":[14327,14323,14330,14326,14325,14328,14324,14332,14331,14333,14321,9070,14334,14329,14322],"class_list":["post-2565","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-web-hosting","tag-directadmin-1-695-update","tag-directadmin-breaking-change","tag-directadmin-evolution-maintenance","tag-directadmin-https-document-root","tag-directadmin-maintenance-task","tag-directadmin-opcache-fix","tag-directadmin-private_html-symlink","tag-directadmin-reseller-update","tag-directadmin-secure-access-group","tag-directadmin-server-update","tag-directadmin-web-server-templates","tag-managed-directadmin-hosting","tag-managed-web-hosting-directadmin","tag-private_html-403-error","tag-private_html-public_html-merge"],"_links":{"self":[{"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2565","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2565"}],"version-history":[{"count":5,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2565\/revisions"}],"predecessor-version":[{"id":2573,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/2565\/revisions\/2573"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=\/wp\/v2\/media\/2566"}],"wp:attachment":[{"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2565"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2565"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.serverspan.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2565"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}