Master Guide: Deploying Plane with SSL Security and Cloudflare
Deployment and advanced securing of Plane Commercial using Nginx, Cloudflare Origin SSL certificates, and strict end-to-end encryption.
Phase 1: System Preparation and Docker
Sección titulada «Fase 1: Preparación del Sistema y Docker»The most common error in the deployment of Plane is having obsolete versions of container orchestrators. We will clean and install the official version compatible with the Plane administrative CLI.
1.1. Debugging and Official Repository
Sección titulada «1.1. Depuración y Repositorio Oficial»# Eliminar versiones conflictivas previassudo apt-get remove docker docker-engine docker.io containerd runc
# Instalar dependencias basesudo apt-get updatesudo apt-get install ca-certificates curl gnupg -y
# Instalar llaves seguras GPGsudo install -m 0755 -d /etc/apt/keyringscurl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpgsudo chmod a+r /etc/apt/keyrings/docker.gpg
# Configurar el repositorio oficialecho \ "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \ $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \ sudo tee /etc/apt/sources.list.d/docker.list > /dev/null1.2. Docker Engine and Compose Plugin Installation
Sección titulada «1.2. Instalación de Docker Engine y Plugin Compose»sudo apt-get updatesudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin -y
# Validación de funcionamientodocker compose versionPhase 2: Plane Installation (Commercial Edition)
Sección titulada «Fase 2: Instalación de Plane (Commercial Edition)»We will adjust the native ports of the Plane proxy container to avoid collisions with the local Nginx web server.
2.1. Installer Download and Initialization
Sección titulada «2.1. Descarga e Inicialización del Instalador»mkdir plane-selfhost && cd plane-selfhostcurl -fsSL https://raw.githubusercontent.com/makeplane/plane/master/deploy/selfhost/install.sh -o setup.shchmod +x setup.sh
# Ejecutar setup indicando la delegación de SSL a un proxy reversosudo ./setup.sh --behind-proxy --domain="plane.portelcore.com"2.2. Port Isolation and Variables in File .env
Sección titulada «2.2. Aislamiento de Puertos y Variables en Archivo .env»We will edit the local configuration so that Plane services listen on dedicated internal ports (8080), freeing up the privileged internet ports (80 and 443) on the host machine for Nginx.
Open the configuration file:
nano .envAlign the following key variables:
# Asignación de puertos de contenedor internosLISTEN_HTTP_PORT=8080LISTEN_HTTPS_PORT=10443
# Enrutamiento SSL corporativoWEB_URL=https://plane.portelcore.comAPI_URL=https://plane.portelcore.com/api
# Enrutamiento del puerto localSITE_ADDRESS=:802.3. Container Restart
Sección titulada «2.3. Reinicio de los Contenedores»sudo prime-cli restartPhase 3: Security Certificates (Cloudflare Origin)
Sección titulada «Fase 3: Certificados de Seguridad (Cloudflare Origin)»To ensure a strict encrypted tunnel between the Cloudflare Edge and your local virtualization server:
- Access your Cloudflare SSL/TLS Origin Server dashboard.
- Create a new Origin Certificate specifying the host name resolution.
- Copy the public certificate and the generated private key strings.
On the local host server:
# Registrar el certificado público de origensudo nano /etc/ssl/certs/plane-origin.pem# (Pegar el contenido del bloque de Cloudflare Origin Certificate)
# Registrar la clave privada de cifradosudo nano /etc/ssl/private/plane-key.pem# (Pegar el contenido del bloque de Private Key)Phase 4: Reverse Proxy Configuration (Nginx)
Sección titulada «Fase 4: Configuración de Proxy Inverso (Nginx)»Nginx will decrypt the incoming SSL encryption and channel the traffic to the Plane containers.
4.1. Nginx Installation
Sección titulada «4.1. Instalación de Nginx»sudo apt update && sudo apt install nginx -y4.2. Creation of the Virtual Server Block
Sección titulada «4.2. Creación del Bloque de Servidor Virtual»sudo nano /etc/nginx/sites-available/planeAdd the standardized routing configuration:
server { listen 443 ssl http2; server_name plane.portelcore.com;
# Rutas a certificados de Cloudflare Origin ssl_certificate /etc/ssl/certs/plane-origin.pem; ssl_certificate_key /etc/ssl/private/plane-key.pem;
# Configuración de Algoritmos de Cifrado Seguros ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers EECDH+AESGCM:EDH+AESGCM; ssl_prefer_server_ciphers on; ssl_session_cache shared:SSL:10m;
# Límite máximo de carga de adjuntos client_max_body_size 10M;
location / { # Redireccionar al puerto de contenedor interno proxy_pass http://127.0.0.1:8080/;
# Cabeceras estándar de enrutamiento inverso proxy_set_header X-Forwarded-Proto $scheme; proxy_set_header X-Forwarded-Host $host; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Real-IP $remote_addr; proxy_set_header Host $http_host;
# Soporte de conexiones WebSockets duraderas proxy_http_version 1.1; proxy_set_header Upgrade $http_upgrade; proxy_set_header Connection "upgrade";
# Tiempos de espera extendidos proxy_read_timeout 300; proxy_connect_timeout 300; }}4.3. Activation and Deployment on Nginx Server
Sección titulada «4.3. Activación y Despliegue en Servidor Nginx»# Enlace simbólico en sitios activossudo ln -s /etc/nginx/sites-available/plane /etc/nginx/sites-enabled/sudo rm /etc/nginx/sites-enabled/default
# Probar la sintaxis del archivosudo nginx -t
# Reiniciar servidor websudo systemctl restart nginxPhase 5: Hardening in Cloudflare (Strict Mode)
Sección titulada «Fase 5: Blindaje en Cloudflare (Strict Mode)»- Go to the SSL/TLS > Overview tab in Cloudflare and set the encryption to Full (Strict) mode.
- Go to SSL/TLS > Edge Certificates and enable the Always Use HTTPS option to force secure redirections.
📊 Guide Quality Criteria
Sección titulada «📊 Criterios de Calidad de la Guía»- ✓ End-to-End Security: Full encryption guaranteed via local Cloudflare Origin certificates.
- ✓ Conflict-Free: Decoupling of container HTTP/HTTPS ports to alternative ports (
8080/10443). - ✓ Active Sockets: Correct WebSocket headers to support instant project synchronization.

