Migrate DOCman 3 to a different siteLast updated: 14 July 2022
- Backup, the backup
- Export from the old site
- Import in the new site
- Move files
- Check menu items
- Check modules
How it works
Migrating data requires the latest DOCman version (3.x) on both sites. You should first upgrade DOCman to the latest maintenance release in both sites.
If you need to migrate a DOCman 2.1 installation check our DOCman 2.1 to DOCman 3.x upgrade tutorial.
What data will be migrated?
Everything except the uploaded files. You will need to move the uploaded files manually.
1. Backup, the backup
Before you start the migration process please make a full backup of your site.
2. Export from the old site
- Upgrade DOCman to the latest versions
- Go to DOCman > settings > Export DOCman data
- Click on Export button to start the export process
- After the process is complete, you should have an export file downloaded
3. Import in the new site
- Install the latest DOCman versions in the new site
- Go to DOCman > settings > Import from ZIP file
- Select the export file you downloaded from the old site to start the import process
4. Move files
You also need to move your files to the new site. They are typically found in the
joomlatools-files directory in the root of your site.
Move your files from
OLD_SITE/joomlatools-files into the
5. Check menu items
DOCman menu items from the old site are migrated into a
Migrated menu items menu type.
We recommend that you move these menu items to the appropriate location using the Menu Manager in the administrator instead of creating new ones.
"Help! I can't create menu items anymore."
When you import data from a different site, sometimes the database gets confused and you end up with a corrupted menu table. As a result, you won't be able to create new menu items. Fortunately, Joomla comes built-in with a easy fix for this: the Rebuild button.
The Rebuild button will reconstruct and refresh your menu table. This button can be found in the toolbar of your Menu Manager. After rebuilding your menu table, you should now be able to create menu items again.
6. Check modules
DOCman modules from the old site are also migrated. You might need to set their position to a different value if the new site is using a different template.