How to Upgrade NocoBase from 2.0 to 2.1

Upgrading from NocoBase 2.0 to NocoBase 2.1 is smooth for the app itself. The bigger change is the NocoBase CLI.

Where:

• In 2.0 and earlier, CLI commands usually start with yarn nocobase
• In 2.1 and later, CLI commands use the globally installed nb

Old apps do not have to move to nb right away. If you only need to upgrade an already stable NocoBase 2.0 app to 2.1, continue using the original installation and upgrade method by default. For newly installed apps, we recommend using the new nb CLI.

Continue Using the Original Installation and Upgrade Method

If you are already used to the previous installation method, you can keep using it. Follow the original installation and upgrade docs as before.

Install NocoBase

• Docker installation
• create-nocobase-app installation
• Git source installation

Upgrade NocoBase

• Upgrade a Docker installation
• Upgrade a create-nocobase-app installation
• Upgrade a Git source installation

Use nb CLI for New Apps

For new apps, we recommend the more convenient nb installation and upgrade flow.

Install NocoBase

• Install NocoBase App

Upgrade NocoBase

• Upgrade NocoBase App

How to Migrate to nb CLI

If you want to manage apps with nb consistently in the future, the more reliable approach for now is to create a new app and migrate the old app data into it.

Migration steps:

1. Create a new CLI app with nb init
2. Migrate the old app's database, storage, and required environment variables
3. After verifying that the new app works properly, switch the production environment over to it

You can also wait for a while. The ability for nb to take over existing local apps is still under development.