Featured Frappe/ERPNext Technology

Switch From Developer to Official Release Branch for Frappe and ERPNext

When you install ERPNext for the first time, you may realize that you are running the developer version of both Frappe and ERPNext. You cannot proceed with the developer branch, as things keep changing, some of which may not be tested thoroughly.

In this video, you will learn how to switch from developer branch to the official release of both apps. I will also show you how to resolve all the issues that arise when you do the movement.

These are the steps you need to take

To switch from Developer to Official Branch, we run the command:

bench switch-to-branch version-13 frappe erpnext

After this has completed executing, the instance will prompt you to run the following command:

bench update –patch

When you run this command, most of the time you will get an error message that says:

No module names bleach_whitelist

When this happens, all you need to do is install this module in your environment. Note, I said environment. If you just run the command without specifying that you are installing it on the environment, it will not work. Frappe runs on an environment, and therefore all dependencies need to be installed on the environment.

Make sure that you are on the root directory of your instance, where you can see the env directory. Run the following command:

./env/bin/pip3 install bleach-whitelist

When this is successful, the command bench update –patch should succeed.

Next, run the below command to gather all requirements and set them onto your instance:

bench setup requirements

When this is successful, your instance should be accessible. You may however notice that the instance has not loaded assets. To load and compile assets to yout instance, run the following command:

bench build

After this is done successfully, your assets will be setup properly, and your instance will look fine. In some cases, you may get the message that your system is being updated. Please refresh again after a few moments. If you encounter such, its a configuration issue. Open sites/common_site_config.json file and locate maintenance_mode. You will find that its value is set to 1. Change the value to 0, so the value should look as shown below:

“maintenance_mode”: 0
That is it! You are all set, your instance should be running fine with the official release of both Frappe and ERPNext.
All the very Best.

 

 

Leave a Reply

Open Chat