Migrate from ERPNext

Tags: setting up migration
  • This migration guide has been tested for ERPNext v11.x.x and v12.x.x
  • It is therefore recommended that you upgrade your ERPNext instance to v11.x.x or v12.x.x before following this guide

Pre-requisites

Your bench environment needs to run on Python 3 (minimum Python 3.6).

If that is not the case, run the following command from your bench folder (`home/{user}/{your_bench}):

bench migrate-env python3

WARNING

dokos is not compatible with Python 2.7

Switch to dokos

Change the default repository URL and update bench

  • In your user's local folder, go to your bench application folder
cd /home/{user}/.bench

or

cd /home/{user}/bench-repo

Usually your user will named be frappe, but it can be any user you have created when installing Frappe/ERPNext

  • Change the remote URL and update the application:
git remote set-url origin https://gitlab.com/dokos/docli.git
git fetch origin
git reset --hard origin/master

Change the default repository URL for each application

  • From your bench folder - usually /home/frappe/frappe-bench - run the following commands
bench remote-reset-url dodock
bench remote-reset-url dokos
  • Then switch to branch master to setup a production environment
bench switch-to-master

TIP

The applications Frappe and ERPNext are not yet renamed to dodock and dokos in bench. Therefore, except for resetting the remote url and installing an application, you still need to call each application with their initial names.

Check that the application is ready to be upgraded

  • From your bench folder - usually /home/frappe/frappe-bench - run the following command
bench remote-urls

The output should contain:

frappe   https://gitlab.com/dokos/dodock.git
erpnext  https://gitlab.com/dokos/dokos.git

Upgrade your application

  • From your bench folder - usually /home/frappe/frappe-bench - run the following command
bench update --reset

If you encounter any issue while upgrading, please open a new issue in the dokos issue tracker