Instalación con Portainer

Esta guía despliega PlexSub desde Portainer usando un stack Docker Compose.

Requisitos

• Portainer funcionando.
• Permiso para crear stacks.
• Claves seguras para PostgreSQL, cifrado y sesiones.
• URL local o dominio público.

Variables de entorno

COMPOSE_PROJECT_NAME=plexsub
APP_IMAGE_REF=ghcr.io/pvpiimoore/plexsub:latest
PLEXSUB_POSTGRES_IMAGE_REF=postgres:18.4-alpine
PORT=5000

POSTGRES_DB=plexsub
POSTGRES_USER=plexsub
POSTGRES_PASSWORD=pega_aqui_una_clave_larga

APP_BASE_URL=https://plexsub.tudominio.com
APP_SETTINGS_ENCRYPTION_KEY=pega_aqui_una_clave_larga
SESSION_SIGNING_SECRET=pega_aqui_otra_clave_larga
TRUST_PROXY_LEVEL=1
FORCE_SECURE_COOKIES=1
PLEXSUB_ALLOW_PRIVATE_TARGETS=0

Si solo pruebas en red local por HTTP, usa APP_BASE_URL=http://IP_DEL_SERVIDOR:5000, TRUST_PROXY_LEVEL=0 y FORCE_SECURE_COOKIES=0.

Stack Compose

services:
  db:
    image: ${PLEXSUB_POSTGRES_IMAGE_REF:-postgres:18.4-alpine}
    restart: unless-stopped
    environment:
      POSTGRES_DB: ${POSTGRES_DB}
      POSTGRES_USER: ${POSTGRES_USER}
      POSTGRES_PASSWORD: ${POSTGRES_PASSWORD}
    volumes:
      - plexsub_postgres_data:/var/lib/postgresql
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U ${POSTGRES_USER} -d ${POSTGRES_DB}"]
      interval: 5s
      timeout: 5s
      retries: 10

  app:
    image: ${APP_IMAGE_REF:-ghcr.io/pvpiimoore/plexsub:latest}
    restart: unless-stopped
    depends_on:
      db:
        condition: service_healthy
    environment:
      NODE_ENV: production
      PORT: ${PORT:-5000}
      DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
      APP_BASE_URL: ${APP_BASE_URL}
      APP_SETTINGS_ENCRYPTION_KEY: ${APP_SETTINGS_ENCRYPTION_KEY}
      SESSION_SIGNING_SECRET: ${SESSION_SIGNING_SECRET}
      TRUST_PROXY_LEVEL: ${TRUST_PROXY_LEVEL:-1}
      FORCE_SECURE_COOKIES: ${FORCE_SECURE_COOKIES:-1}
      PLEXSUB_ALLOW_PRIVATE_TARGETS: ${PLEXSUB_ALLOW_PRIVATE_TARGETS:-0}
    ports:
      - "${PORT:-5000}:5000"
    volumes:
      - plexsub_backups_data:/app/backups
      - plexsub_backup_fallback_data:/app/backup-fallback
      - plexsub_uploads_data:/app/uploads
    security_opt:
      - no-new-privileges:true
    read_only: true
    tmpfs:
      - /tmp
      - /var/tmp
    cap_drop:
      - ALL
    cap_add:
      - NET_BIND_SERVICE

volumes:
  plexsub_postgres_data:
  plexsub_backups_data:
  plexsub_backup_fallback_data:
  plexsub_uploads_data:

Despliegue y validación

1. Crea un stack llamado plexsub.
2. Pega las variables y el Compose.
3. Pulsa Deploy the stack.
4. Revisa que db esté healthy y app running.
5. Abre /adminportal y completa el asistente inicial.

No borres volúmenes si quieres conservar datos. No uses postgres:latest.