If your looking to change the domain of one or many of the stores configured for you Magento instance this guide is for you. You may want to do this if you are moving away from a development domain and going live.
(If you use a WAF such as Cloudflare you may not need to carry these steps, please reach out to us.)
If you aren't using a WAF we would strongly encourage you to do so, for both security and ease of DNS / SSL management, though this isn't a requirement when hosted with MDOQ.
1. DNS change
You will need to have access to the domain control panel before carrying this out.
MDOQ does not have the ability to control your domain.
When you are ready to swap the domain go into your domain control panel and change the IP address of the associated records.
You can find the IP of your production site in MDOQ by:
- selecting your production site
- selecting "Settings"
- Then scroll down to Server IP
N.B it is a good idea to lower the TTL for any records you are going to be changing will in advance. Change the TTL to the lowest possible value, this should minimise any downtime. After the migration has completed, you can increase the TTL again.
2. MAP settings
You can now go into the MAP (Magento Admin Panel) of your instance and change the store settings to the domain you are wanting to move to.
3. Disable existing site
If the domain you are wanting to swap to is in use by another site, now would be a good time to enable a maintenance page. This will make it much easier to determine once the DNS has propagated.
4. Nginx sync
Within MDOQ:
- Select your production site
- Select "Sync"
- Click "Select components to synchronize"
- Click "show more"
- Click "enable advanced mode"
- Check "Only synchronize selected components"
- Check "Site Nginx"
It should look like this
- Click "Synchronize"
This process will take a few minutes.
Once complete the site will be accessible, but the SSL certificate may not be valid.
5. SSL Validation
Until the DNS is pointing at your production site, MDOQ is unable to automatically generate an SSL certificate for you.
However when you trigger the sync of Nginx, MDOQ will realize it doesn't have an SSL for the new domain(s) and automatically start the process to generate them. This process can take 5-10mins, depending on how long DNS takes to propagate.
You should need to take any action.
If you haven't got a valid SSL certificate after 15mins, please raise a ticket with our support team.