Configure external PostgreSQL, Redis and S3 storage
The Prime CLI lets you easily configure your Commercial Edition instance, providing options to customize the PostgreSQL database, Redis, external storage, and other advanced settings.
-
Run the Prime CLI with ↓:
sudo prime-cli
-
Once the CLI is running, enter
configure
, which will guide you through a step-by-step form where you can specify the following:-
Listening port
Define the port for the built-in reverse proxy.
Default:80
-
Max file-upload size
Set the maximum file size (in MB) that members can upload. Default:5 MB
-
External Postgres URL
Provide the URL of your external PostgreSQL instance if you want to switch from the default Plane configuration. Default:Postgres 15.5
in the Docker container.Don’t use a database on your local machine. If you use
localhost
in the URL, it won’t work. Make sure to use a database hosted on a network-accessible server.Avoid using special characters in your PostgreSQL password.
-
External Redis URL
Specify the URL of your external Redis instance to override the default Redis configuration.
Default:Redis 7.2.4
-
External storage
Plane currently supports only S3 compatible storages.
Default:MinIO
- Ensure your IAM user has the following permissions on your S3 bucket.
- s3:GetObject
To access the objects. - s3:PutObject
To upload new assets using the presigned url.
- s3:GetObject
- Configure the CORS policy on your bucket to enable presigned uploads. Use the example policy below, making sure to replace
<YOUR_DOMAIN>
with your actual domain. - Switch to your external storage by providing the following values:
- S3 access key ID
- S3 secret access key
- S3 bucket name
- S3 region
- S3 endpoint URL
- Ensure your IAM user has the following permissions on your S3 bucket.
-
-
After confirming your choices, your instance will automatically restart with the updated configuration.
Community Edition
Community Edition
To configure external Postgres, Redis, and S3 storage for the Plane Community Edition, you’ll need to adjust several environment variables in the plane.env file. Follow this guide to set up each component using the correct values for your external services.
-
Open the
plane.env
file on your server where Plane is installed. -
In the DB SETTINGS section, update the variables to connect to your external Postgres instance:
Don’t use a database on your local machine. If you use
localhost
in the URL, it won’t work. Make sure to use a database hosted on a network-accessible server.Avoid using special characters in your PostgreSQL password.
-
In the REDIS SETTINGS section, update the variables to connect to your external Redis instance:
-
In the DATA STORE SETTINGS section, update the variables for any S3-compatible storage:
-
Save your changes to the
plane.env
file. -
Restart Plane services to apply the new settings using the
setup.sh
script.