Skip to content

Commit 09859a4

Browse files
committed
Add note on cloud database and S3 storage during migration from Community to Commercial
1 parent 7beb3fc commit 09859a4

2 files changed

Lines changed: 59 additions & 0 deletions

File tree

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
title: Upgrade from Community to Commercial Edition
3+
sidebarTitle: Upgrade to Commercial Edition
4+
---
5+
6+
This guide walks you through updating your configuration to migrate existing data from a **Community** setup to a **Commercial** environment.
7+
8+
## Step 1: Navigate to the Plane directory
9+
10+
```bash
11+
cd /opt/plane
12+
```
13+
14+
## Step 2: Open the environment configuration file
15+
16+
```bash
17+
vim plane.env
18+
```
19+
20+
## Step 3: Update the database connection
21+
22+
1. Search for the `DATABASE_URL` environment variable.
23+
24+
2. Replace the existing value with your **remote (managed) database URL**.
25+
26+
Example:
27+
28+
```env
29+
DATABASE_URL=postgres://user:password@remote-host:5432/dbname
30+
```
31+
32+
## Step 4: Update datastore (object storage) settings
33+
34+
1. Search for the `#DATASTORE SETTINGS` section in `plane.env`.
35+
36+
2. Update the following environment variables as required for your managed storage setup:
37+
38+
```env
39+
USE_MINIO=0
40+
AWS_REGION=<your-region>
41+
AWS_ACCESS_KEY_ID=<access-key>
42+
AWS_SECRET_ACCESS_KEY=<secret-key>
43+
AWS_S3_ENDPOINT_URL=<s3-endpoint-url>
44+
AWS_S3_BUCKET_NAME=uploads
45+
```
46+
47+
> ⚠ Setting `USE_MINIO=0` disables the local MinIO service and enables external object storage (e.g., S3 or S3-compatible services).
48+
49+
## Step 5: Restart Plane services
50+
51+
Apply the changes by restarting the services:
52+
53+
```bash
54+
prime-cli restart
55+
```

self-hosting/upgrade-from-community.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,10 @@ The instructions provided on this page are specific to installations using Docke
1616
- Install the [Commercial Edition](/self-hosting/methods/docker-compose#recommended-edition) on a fresh machine, not the one running the Plane Community Edition.
1717
- Be sure to log in as the root user or as a user with sudo access. The `/opt` folder requires sudo or root privileges.
1818

19+
<Note>
20+
No backup is required if you are using a cloud database and S3 storage while migrating from Community to Commercial. Simply point your Commercial instance to the same cloud database and S3 storage. Refer to [this guide](https://app.plane.so/plane/wiki/5e4a0b13-fc55-4a3f-896f-9f0a829bfc8b/) for more details.
21+
</Note>
22+
1923
## Back up data on Community instance
2024
1. Download the latest version of `setup.sh`.
2125
```bash

0 commit comments

Comments
 (0)