How to Move Joomla from a Subdirectory to the Domain Root

Moving Joomla from a subdirectory such as /joomla to the domain root changes both the filesystem location and public URL paths. A safe move backs up first, confirms the real document root, moves the entire installation, removes old path assumptions, and redirects former subdirectory URLs.

Back up the current installation

Create a complete filesystem and database backup before changing the document location. Record the working subdirectory URL and its server path. For a site receiving frequent writes, use a short maintenance window so the source does not change while files are being moved.

Confirm the real domain document root

Use the hosting control panel or web-server configuration to identify the actual document root for the domain. Inspect it for an existing application, index file, rewrite rules, or verification files. Archive conflicts before removing them; public_html is not always the correct root for addon or separately configured domains.

Move the complete Joomla file tree

Move or copy every Joomla file and directory from the subdirectory to the domain root, including intentional hidden files such as .htaccess. Preserve directory structure and apply the host's ownership and permission model. Do not leave a second publicly active Joomla copy that can receive writes.

Correct filesystem and rewrite assumptions

If the filesystem location changed, update valid writable log and temporary paths in configuration.php. Review Apache, Nginx, or IIS rewrite configuration and any customized RewriteBase. Check templates, custom scripts, extension settings, and asset paths for hard-coded references to the old subdirectory.

Redirect the old subdirectory URLs

Map old /subdirectory/... URLs to their equivalent root URLs where the content still exists. Prefer direct permanent redirects rather than chains. Test old bookmarks, search-result URLs, images, downloads, and extension routes so the move does not create avoidable 404 errors.

Verify the root installation

Test the home page, several deep SEF URLs, /administrator, media, forms, login, modules, uploads, scheduled tasks, and extension-specific views. Inspect browser network requests and server logs for references to the old subdirectory. Once the root copy is stable, remove or secure the obsolete source directory and create a fresh backup.


Need More Help with Joomla?

Still having trouble? Open a support ticket with QuantaCade Support and we\'ll be happy to help where we can.

Support priority is given to QuantaCade products, services, and customers. However, we\'re also happy to assist fellow Joomla users with general Joomla questions and troubleshooting when possible.

QuantaCade is an independent Joomla extension developer and is not official Joomla support. Some issues involving third-party extensions, hosting environments, server configurations, or other systems outside our development control may be beyond what we\'re able to resolve.

Open a Support Ticket