Skip to main content

Deploy Plane with Podman Quadlets • Commercial Edition

This guide explains how to deploy Plane using Podman Quadlets on a self-hosted environment.

Prerequisites​

  • Podman 4.4 or later
  • Systemd support
  • Access to a Linux server (amd64 or arm64)

Download Deployment Files​

  1. Download the Podman Quadlet files for your Plane version:

    curl -fsSL https://prime.plane.so/releases/<plane-version>/podman-quadlets.tar.gz -o podman-quadlets.tar.gz
    tar -xzvf podman-quadlets.tar.gz
    warning

    Replace <plane-version> with v1.8.2 or higher.

  2. Download the environment variables file:

    curl -fsSL https://prime.plane.so/releases/<plane-version>/variables.env -o plane.env

Configure Environment Variables​

Edit plane.env and set the following variables:

  • DOMAIN_NAME — (required) Your application's domain name
  • SITE_ADDRESS — (required) The full domain name (FQDN) of your instance
  • MACHINE_SIGNATURE — (required) Unique identifier for your machine. Generate with: 
    sed -i 's/MACHINE_SIGNATURE=.*/MACHINE_SIGNATURE='$(openssl rand -hex 16)'/' \
    plane.env
  • CERT_EMAIL — (optional) Email for SSL certificate generation (needed for HTTPS)

Configure External Services​

warning

For production, configure external database and storage to ensure data security and reliability. Relying on local storage increases the risk of data loss and service disruption.

  • DATABASE_URL — Connection string for your external database
  • REDIS_URL — Connection string for your external Redis instance
  • AMQP_URL — Connection string for your external RabbitMQ server

Deploy with Podman Quadlets​

  1. Copy the extracted .quadlet files to the systemd directory: 
    sudo cp *.quadlet /etc/containers/systemd/
  2. Reload systemd and start the Plane services: 
    sudo systemctl daemon-reload
    sudo systemctl start plane.target
    sudo systemctl enable plane.target

Plane should now be running on your configured domain.