Looking for up-to-date Help documentation? Documentation for the latest releases of Totara is now available at totara.help!

Visit the new Help site

You may find you need to move your Totara Learn site from one server to another, for a variety of reasons including changes to infrastructure and hosting. 

Recommended migration method

If you wish to migrate your site from one server to another, then we recommend you follow these steps:

  1. Within the quick-access menu go to Server > Maintenance mode and enable maintenance mode.
  2. Back up the Totara database on the old server.
  3. Restore the database backup to the new server.
  4. Copy dataroot from the old server to the new server.
  5. Copy the Totara code from the old server to the new server.
  6. Take the site out of maintenance mode.

This method should be used if you are migrating your site without changing the site's URL.


There are a number of consideration to take into account when migrating a site from one server to another, these include whether you wish to upgrade at the same time, as well as some security issues. 


You may also wish to upgrade you site (either from Moodle or from an earlier version of Totara Learn) during the migration process. Although this can be a useful way to save time it does pose some risks, mainly that if anything goes wrong during the joint upgrade and migration process it will be harder to know which process triggered the issue. If you carry out the processes separately it will be easier to isolate a problem and rectify it.

We strongly recommend that you complete the migration and any upgrades separately.

Security issues

As you are moving from one server to another it is important to consider the setup of this new server and any security changes that may have occurred during the transition. This is especially important in regards to things like, DNS setup as well as internal and external access (the new server might not have the same firewalls setup). It is advised that you consider all of these things carefully to ensure you do not forget to enable something on the new server.

If you have Email-based self-registration enabled as an authentication method then you will need to enter new API keys to ensure that the ReCAPTCHA keys are generated from Google. 

On this page

Provide feedback about this page using the link in the bottom right of this page. 

Still have questions? Why not post them in the forums of the Totara Community?

  • No labels