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 backup your current installation, transfer the data, and restore it in your air-gapped setup.
Important
Make sure you already have 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.
- Be sure to log in as the root user or as a user with sudo access. The
/opt
folder requires sudo or root privileges.
Backup data on Community instance
-
Download the latest version of
setup.sh
. -
Run the setup.sh backup script to take the backup of the Community Edition instance.
This will create a backup of the plane community instance in the
backup/
folder with the timestamp as the folder name.
Restore data on Airgapped instance
-
Download the latest version of
restore-airgapped.sh
This allows you to restore the Community Edition data to the Commercial Airgapped instance.
-
Copy the
restore-airgapped.sh
script into your backup folder. -
Move your entire backup folder to the server running the Commercial Airgapped Edition.
-
Open terminal, and execute the following command:
This will prompt you to enter the Commercial Airgapped Edition installation folder using whatever secure method works in your environment.
-
After the data restore is finished, start the instance.
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.