Instalación en Unraid

Esta guía orienta una instalación de PlexSub en Unraid usando Docker Compose o un stack equivalente.

Requisitos

• Unraid con Docker activo.
• Soporte para Docker Compose o plugin equivalente.
• Carpeta persistente para PlexSub.
• Claves seguras para base de datos, cifrado y sesiones.
• Dominio o reverse proxy si quieres acceso externo con HTTPS.

Carpeta recomendada

/mnt/user/appdata/plexsub

Guarda ahí docker-compose.yml y .env.

Variables básicas

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=http://IP_DE_UNRAID:5000
APP_SETTINGS_ENCRYPTION_KEY=pega_aqui_una_clave_larga
SESSION_SIGNING_SECRET=pega_aqui_otra_clave_larga
TRUST_PROXY_LEVEL=0
FORCE_SECURE_COOKIES=0
PLEXSUB_ALLOW_PRIVATE_TARGETS=0

Si usas dominio HTTPS:

APP_BASE_URL=https://plexsub.tudominio.com
TRUST_PROXY_LEVEL=1
FORCE_SECURE_COOKIES=1

Compose básico

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
    env_file:
      - .env
    environment:
      NODE_ENV: production
      PORT: ${PORT:-5000}
      DATABASE_URL: postgresql://${POSTGRES_USER}:${POSTGRES_PASSWORD}@db:5432/${POSTGRES_DB}
    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:

Primer acceso

Abre http://IP_DE_UNRAID:5000/adminportal. En una instalación limpia, crea el primer usuario Owner desde el asistente inicial.

Backups y PostgreSQL

Protege el volumen PostgreSQL, backups, uploads y .env. No cambies APP_SETTINGS_ENCRYPTION_KEY si ya tienes integraciones guardadas.

Usa postgres:18.4-alpine en instalaciones limpias. No apuntes un volumen antiguo a un major nuevo de PostgreSQL sin backup, restore y validación.