In order to upgrade from an older 1.x version of Wiki.js, you need to first install Wiki.js 2.x using the standard installation instructions.
Because of the significant architecture differences between v1 and v2, you cannot do an in-place upgrade.
You need to first do a fresh v2 installation from which you'll import content, uploads and users into.
Once your new v2 installation is working, follow the instructions below to bring content, uploads and users from your older v1 installation into your new v2 installation.
If you were using a remote Git repository to sync content to in your v1 installation, choose Import from Git connection.
Otherwise, choose Import from local folder.
Enter all the required connection information to connect to your remote Git repository. These settings should be the same as the one entered in your v1
config.yml file under the git section.
If using the SSH authentication method, you'll need to copy the contents of the file you were referencing in v1 into the Private Key Contents field.
For most scenarios, you should leave the default value of
./data/repofor the Local Repository Path field. This folder should be empty and dedicated to v2.
DO NOT point to your current v1 local repository folder.
Enter the path to the local repository folder used in your v1 installation.
Enter the MongoDB database connection string, as entered in your v1 installation
Select how groups and permissions should be created. It's recommended to use the first option which will put users that have the same permissions into the same group.
When ready, click the Start Import button to initiate the migration process. You'll be notified of any failure in importing content and a list of users that could not be imported will be displayed.
It's safe to retry the migration process as many times as needed. No duplication will occur as users that already exists will be skipped and content will be updated.
Once the migration is completed and you've verified that content, uploads and users were successfully copied over, make sure to read the following recommendations:
./data/content). Additionally, unless you want content to be exported to disk on change, you may disable the Local File System storage module completely.