Saltar al contenido principal

Requisitos y compatibilidad

Qué necesitas para ejecutar PlexSub​

PlexSub está pensado para ejecutarse como aplicación self-hosted con Docker Compose. La plantilla pública del proyecto usa dos servicios:

  • app: aplicación PlexSub.
  • db: PostgreSQL.

Los archivos de referencia son:

  • docker-compose.example.yml
  • .env.example
  • Dockerfile

Docker y Docker Compose​

Requisito real documentado: PlexSub se despliega con Docker Compose.

Comandos habituales:

docker compose pull
docker compose up -d
docker compose ps

La guía pública recomienda copiar docker-compose.example.yml y .env.example a una carpeta de runtime fuera del checkout de código.

PostgreSQL​

La plantilla actual usa PostgreSQL:

  • Imagen por defecto: postgres:18.4-alpine
  • Variable de imagen: PLEXSUB_POSTGRES_IMAGE_REF
  • Volumen de datos: plexsub_postgres_data
  • Ruta montada en el contenedor: /var/lib/postgresql

Importante:

  • No cambies de versión mayor de PostgreSQL recreando el contenedor encima del mismo volumen.
  • Antes de subir de versión mayor, haz copia de seguridad y prueba restauración.
  • Si vienes de un PostgreSQL anterior, trata la migración como operación controlada de dump/restore o equivalente.

Recursos mínimos​

El proyecto no publica una tabla cerrada de requisitos mínimos por número de usuarios. Lo que sí está definido en docker-compose.example.yml son límites y reservas recomendadas para el despliegue de ejemplo:

Servicio

Reserva CPU

Límite CPU

Reserva RAM

Límite RAM

app

1 CPU

2 CPU

512 MB

1 GB

db

0,5 CPU

1 CPU

256 MB

512 MB

Lectura práctica:

  • Para una instalación pequeña, usa como mínimo los recursos reservados por la plantilla.
  • Si activas muchas integraciones, consultas de historial, búsquedas o módulos de descargas, deja margen adicional.
  • Mantén espacio libre suficiente para PostgreSQL, backups y uploads.

Arquitectura soportada​

El Dockerfile usa imágenes Alpine de Node 24 y PostgreSQL Alpine. El repositorio no publica una matriz oficial de arquitecturas CPU.

Por tanto:

  • Usa arquitecturas soportadas por las imágenes Docker que vayas a ejecutar.
  • Verifica que la imagen concreta que has fijado por digest existe para tu plataforma.
  • Si usas NAS, Unraid, ARM o hardware poco habitual, valida primero con docker compose pull y docker compose up -d.

Runtime de Node​

El código declara:

  • Node.js: >=24.0.0 <25.0.0
  • Imagen runtime: node:24-alpine

Para desarrollo local, usa Node 24. Para producción, la vía recomendada es Docker.

El repositorio no define una matriz oficial de navegadores soportados. PlexSub es una aplicación web moderna con frontend React.

Recomendación para usuarios:

  • Usa versiones actuales de Chrome, Edge, Firefox o Safari.
  • Evita navegadores antiguos o WebViews desactualizadas.
  • Si ves errores visuales, prueba primero en un navegador actualizado de escritorio.

Red y puertos​

Por defecto:

  • La aplicación escucha dentro del contenedor en el puerto 5000.
  • La plantilla publica ${PORT:-5000}:5000.
  • En la demo pública, el compose liga el puerto a 127.0.0.1:${DEMO_PORT:-5001}:5000.

Si expones PlexSub a Internet:

  • Usa HTTPS.
  • Configura correctamente APP_BASE_URL.
  • Configura TRUST_PROXY_LEVEL solo si hay un proxy de confianza delante.
  • Mantén FORCE_SECURE_COOKIES=1.