Instalación

QuoteNode se ejecuta como contenedores Docker. En un despliegue normal no necesitas instalar Java, Node.js, PostgreSQL ni Gotenberg en el host. La decisión principal es desde dónde será accesible la aplicación: solo desde tu portátil, desde la red de la oficina (LAN) o desde internet.

Cada guía instala un paquete de versión: un archivo Compose que ejecuta las imágenes probadas de la versión, fijadas por digest. No se compila nada en tu equipo, y cada instalación de una versión usa las mismas imágenes. Las imágenes de las versiones se construyen para hosts x86 de 64 bits (linux/amd64).

Elige tu forma de despliegue

Topología	Dirección	Enlaces públicos de ofertas	Enlaces en correos	HTTPS	Uso previsto
Portátil/local	http://localhost	solo en el mismo equipo	inútiles para clientes externos	no	prueba/demo
Windows en LAN	http://<ip-del-pc> o DNS local	solo clientes de la LAN	solo destinatarios internos	opcional/interno	prueba en la oficina
Servidor Linux en LAN	http://<ip-del-servidor> o DNS local	solo clientes LAN/VPN	internos salvo que sean accesibles	opcional/interno	equipo comercial interno
Servidor público Ubuntu (VPS)	dominio público + HTTPS	funcionan para los clientes	funcionan con SMTP y dominio configurados	obligatorio	producción beta
Portainer/QNAP/NAS	interfaz Docker propia del host	según enrutamiento/NAT/dominio	según enrutamiento/SMTP	obligatorio para enlaces de clientes	uso avanzado doméstico/pyme
Coolify	dominio público + proxy gestionado	funcionan para los clientes	funcionan con SMTP y dominio configurados	gestionado por Coolify	el despliegue público más sencillo

Guías de instalación

• Portátil local — evaluación rápida en un solo equipo.
• Servidor Windows en LAN — Docker Desktop en un PC accesible en la red de la oficina.
• Servidor Linux en LAN — Docker Engine en un servidor interno o una VM.
• Servidor público Ubuntu — dominio público, HTTPS, SMTP, copias de seguridad y conceptos básicos de cortafuegos.
• Coolify — paquete de versión en un recurso Docker Compose de Coolify, detrás de su proxy.
• Portainer, QNAP o NAS — indicaciones avanzadas para plataformas con interfaz Docker.
• Actualizar QuoteNode — pasar al siguiente paquete de versión y revertir con seguridad.

Referencias comunes

• Variables de entorno del despliegue — variables mínimas para las guías de instalación.
• Solución de problemas de instalación — problemas habituales con enlaces, CORS, SMTP, DNS y pérdida de secretos.
• Referencia de variables de entorno — catálogo completo de variables.
• Copias de seguridad y recuperación — estrategia de copias y restauración.
• Opciones de despliegue — visión general a nivel de arquitectura.

Antes de publicar enlaces

QuoteNode genera enlaces públicos de ofertas, enlaces a las preferencias de notificación y correos electrónicos. Esos enlaces solo funcionan para destinatarios que pueden llegar a la misma dirección que usa el navegador.

• Un enlace generado en http://localhost solo funciona en el mismo equipo.
• Un enlace generado en http://192.168.x.x solo funciona para personas de esa LAN o VPN.
• Un enlace generado en https://crm.example.com funciona públicamente solo con DNS, HTTPS, enrutamiento del proxy y cortafuegos bien configurados.
• El envío de correos requiere SMTP. La descarga manual del PDF y el envío manual de un enlace público no.

Recursos mínimos

Despliegue	RAM	CPU	Disco
Evaluación / uso individual	2 GB	1 núcleo	10 GB SSD
Equipo pequeño	4 GB	2 núcleos	20 GB SSD
Entorno beta más amplio	8 GB	4 núcleos	50 GB SSD

Son valores iniciales prudentes. Los catálogos grandes, la generación frecuente de PDF, muchas copias de seguridad y las imágenes de productos aumentan las necesidades de disco y memoria.

Los límites de los contenedores, el ajuste de RAM/CPU y cómo evitar la falta de memoria se describen en Recursos del sistema.