If you’re upgrading from v0.13.2 or below, there are some additional migration steps due to significant changes in the self-hosting setup. Follow these instructions to migrate your data to the new volume structure in v0.14.0.

  1. First, stop the running v0.13-2 (or older) instance of Plane. If it’s still running, you might hit a “ports not available” error, which will prevent the v0.14-0 containers from starting up correctly.

    docker compose down

  2. Create a new folder for v0.14-0 to ensure a clean installation.

    mkdir plane-selfhost
cd plane-selfhost

  3. Set up the environment variable for the RELEASE variable, then download and prepare the installation script:

    export RELEASE=v0.14-dev
curl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh | sed -e 's@BRANCH=${BRANCH:-master}@BRANCH='"$RELEASE"'@' -e 's@APP_RELEASE="stable"@APP_RELEASE='"$RELEASE"'@' > setup.sh
chmod +x setup.sh

  4. Execute the script to install Plane:

    ./setup.sh install

  5. Start up your new v0.14-0 Plane instance:

    ./setup.sh start

  6. Now stop the instance to initialize the new Docker volumes:

    ./setup.sh stop

  7. Download the migration script:

    curl -fsSL -o migrate.sh https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/migration-0.13-0.14.sh
chmod +x migrate.sh

  8. Run the migration script:

    ./migrate.sh

    You’ll see the following instructions:

    ******************************************************************

This script is solely for the migration purpose only.
This is a 1 time migration of volume data from v0.13.2 => v0.14.x

Assumption:
1. Postgres data volume name ends with _pgdata
2. Minio data volume name ends with _uploads
3. Redis data volume name ends with _redisdata

Any changes to this script can break the migration.

Before you proceed, make sure you run the below command
to know the docker volumes

docker volume ls -q | grep -i "_pgdata"
docker volume ls -q | grep -i "_uploads"
docker volume ls -q | grep -i "_redisdata"

*******************************************************

Given below list of REDIS volumes, identify the prefix of source and destination volumes leaving "_redisdata"
---------------------
plane-app_redisdata
v0132_redisdata

Provide the Source Volume Prefix :

  9. Open a second terminal and run the commands shown above to identify your source and destination volume prefixes. For example, if you run docker volume ls -q | grep -i "_pgdata", you might see something like:

    In this example, plane-013-dev is the prefix for v0.13.2, and plane-app is the prefix for v0.14.0.

  10. Return to the original terminal, enter the source volume prefix plane-013-dev and destination volume prefix plane-app, and press ENTER:

    Provide the Source Volume Prefix : plane-013-dev
Provide the Destination Volume Prefix : plane-app

    If there are any issues, an error will appear. For a successful migration, there will be no error, and the process will exit quietly.

  11. Restart the upgraded v0.14.0 instance with:

    ./setup.sh restart

  12. Login as instance admin by appending /god-mode to your domain.

  13. Once logged in, just click Save Changes to finalize your setup.

  14. You’re all set! Log in to your updated v0.14-0 instance to check if all of your data has migrated successfully.

  15. Now, update to the latest version.

Update to latest versionView logs