Skip to main content

Upgrade from Community to Airgapped Edition

This guide walks you through migrating your existing Plane Community Edition data to an air-gapped environment. You'll back up your current installation, transfer the data, and restore it in your air-gapped setup.

Important

Make sure you already have the Commercial Airgapped Edition installed on a fresh machine before starting this migration. If you haven't installed it yet, follow our airgapped installation guide first.

Prerequisites​

  • Install the Commercial Airgapped Edition on a fresh machine, not the one running the Community Edition.
  • Log in as the root user or as a user with sudo access. The /opt folder requires sudo or root privileges.

Back Up Data on Community Instance​

  1. Download the latest version of setup.sh:

    curl -fsSL https://github.com/makeplane/plane/releases/latest/download/setup.sh -o setup.sh

  2. Run the setup.sh backup script to back up the Community Edition instance:

    ./setup.sh backup

    This will create a backup of the Plane Community instance in the backup/ folder with the timestamp as the folder name.

    backup/
    └── 20250605-0938
        ├── pgdata.tar.gz
        ├── rabbitmq_data.tar.gz
        ├── redisdata.tar.gz
        └── uploads.tar.gz

Restore Data on Airgapped Instance​

  1. Download the latest version of restore-airgapped.sh:

    curl -fsSL https://github.com/makeplane/plane/releases/latest/download/restore-airgapped.sh -o restore-airgapped.sh
    chmod +x restore-airgapped.sh

    This allows you to restore the Community Edition data to the Commercial Airgapped instance.

  2. Copy the restore-airgapped.sh script into your backup folder.

  3. Move your entire backup folder to the server running the Commercial Airgapped Edition.

  4. Open a terminal and execute the following command:

    sudo bash restore-airgapped.sh ./20250605-0938

    This will prompt you to enter the Commercial Airgapped Edition installation folder using whatever secure method works in your environment.

  5. After the data restore is finished, start the instance:

    cd <airgapped-instance-folder>
    sudo docker compose -f docker-compose.yml --env-file plane.env up -d

    You can now access the Commercial Airgapped instance at http://<ip-address|domain-name>

Once your migration is complete, verify that all your projects, issues, and team data have been successfully transferred to your air-gapped environment.