Search The Hostwinds Guides Knowledge Base

How To Change Joomla Domain Name

Share This Article [TheChamp-Sharing]

There may come a time when your domain name needs to be changed for your Joomla installation. Whether it be for your new website, or if you chosen to use a new domain name for SEO purposes. Either way, this is entirely possibly with Joomla, and fairly simple to get taken care of.

Where is the Option to Change the Main Domain?

First thing to note, is that this option is not changed within the Joomla Dashboard. But rather is changed in a File that Joomla reads from. You can either use the cPanel File Manager or an FTP Program like FileZilla to edit this file.

How Do I Edit The Domain Through cPanel File Manager?

  1. You will want to start off by logging into your cPanel.
  2. Once logged into cPanel, you will want to find the File Manager icon. This will be in the Files section of cPanel. Then click on that icon to open up the File Manager.
    Close up view of where to locate the file manager
  3. From the File Manager, you will navigate to the location where Joomla is installed. This will be somewhere inside the public_html folder.
    1. If you had installed Joomla using Softaculous, you can login to Softaculous and click on the All Installations icon (
      softaculous all installations icon
      )and then use the little pencil icon (
      softaculous edit details
      ) to view the path of where this was installed.
    2. If you installed Joomla manually using an FTP client, have more than one domain on the cPanel account, and it is not installed on the main domain, then you will want to locate where this was installed to and ensure you are navigating to the right directory.
  4. After you have found the Joomla installation folder. There will be a file called, “configuration.php“. You will want to right click on that file and choose edit.
    Where to find the configuration File for Joomla to Edit
  5. There will be a screen that pops up, you can just click “Edit” towards the bottom of that window. Which will bring the file open for editing.
  6. With the configuration.php file open, you will want to navigate and find the line that says “public $live_site = ‘’;“. You will change that line from what it is currently, to the new domain that you are wanting to use.
    What to edit in the configuration.php file
  7. After that is done, you will click on “Save Changes” in the top right of the editor. Then the changes should now reflect on your site. If it does not show, you may need to clear your browser’s cache to see the changes.

Do I Have To Do This Through cPanel?

No, you do not need to do this through cPanel. You can download the file, either through the File Manager or FTP. Once you have the file open, you would make the same changes as listed above, and save it. Make sure that you upload the modified configuration.php file to the correct folder.

If you should have any questions or would like assistance, do feel free to contact us through Live Chat or by submitting a ticket with our Technical Support team.