Instalar Noctcom

Self-host gratis · AGPL-3.0

Proxmox VE · LXC

Instala Noctcom en Proxmox VE

Despliega tu propia instancia como contenedor **LXC** en un host Proxmox VE. Un solo comando crea el contenedor, instala Docker y levanta todo el stack, aislado del host.

Instalar · como root en el host
# Ejecútalo en el nodo Proxmox, no dentro de una VM/LXC
$ bash <(curl -fsSL https://raw.githubusercontent.com/RedderLabs/noctcom/main/proxmox/noctcom-lxc.sh)

Te preguntará el dominio (déjalo vacío para modo LAN por IP). Al terminar muestra la URL de acceso y el ID del contenedor (CTID).

Qué hace la instalación

Crea un LXC

Un contenedor Debian no privilegiado, con nesting y keyctl activados para que Docker funcione dentro.

Instala Docker

Prepara Docker y Docker Compose dentro del contenedor, sin que toques nada en el host.

Levanta el stack

PostgreSQL, Redis, MinIO, backend, frontend y Caddy con TLS automático. Al final te da la URL y el CTID.

Requisitos

Proxmox VE 8.x o 9.x · acceso root
2 vCPU
4 GiB de RAM
20 GB de disco

La RAM importa: el build de Next.js necesita más de 2 GiB. No bajes de 4 GiB salvo que sepas lo que haces.

Qué corre dentro del contenedor

Todo el stack vive en un único LXC, aislado del resto del host Proxmox.

LXC Debian · no privilegiado
PostgreSQL
Base de datos
Redis
Caché y colas
MinIO
Almacenamiento de objetos
Backend
API
Frontend
Interfaz web
Caddy
Proxy y TLS

Tus archivos se cifran en el navegador: ni el servidor ni quien administre el host puede leer su contenido.

Personaliza la instalación

Pasa variables de entorno antes del comando para ajustar recursos o red. Las más útiles:

VariablePor defectoPara qué sirve
NOCTCOM_RAM4096MiB de RAM (el build de Next.js pide más de 2 GiB).
NOCTCOM_DOMAIN—Dominio; vacío = modo LAN por IP.
NOCTCOM_EMAIL—Email para los certificados TLS (cuando usas dominio).
NOCTCOM_CORES2Número de vCPUs del contenedor.
NOCTCOM_DISK20GB de disco del rootfs.
NOCTCOM_NONINTERACTIVE01 = no preguntar nada y usar los valores por defecto.

Mantenimiento

Sustituye <CTID> por el ID que te dio la instalación.

Actualizar
# git pull + migraciones + rebuild, sin tocar tus secretos
$ pct exec <CTID> -- bash -lc 'cd /opt/noctcom && bash update.sh'
Estado
# Ver los servicios del stack
$ pct exec <CTID> -- bash -lc 'cd /opt/noctcom && docker compose ps'
Logs
# Seguir los logs del backend
$ pct exec <CTID> -- bash -lc 'cd /opt/noctcom && docker compose logs -f backend'

Problemas frecuentes

«No encuentro pct / pveam / pvesh»
Estás ejecutando el script dentro de una VM o LXC, no en el host. Conéctate al nodo Proxmox como root.
El build se queda sin memoria o se mata
Sube NOCTCOM_RAM (mínimo recomendado 4096; Next.js necesita más de 2 GiB para compilar).
No carga con dominio
Revisa que el DNS apunte a la IP correcta y que los puertos 80 y 443 lleguen al LXC (NAT o port-forward en tu router o firewall).
La IP del LXC cambió y la app no conecta con la API (modo LAN)
La URL de la API queda integrada en el build del frontend. Reserva la IP en tu DHCP y reinstala, o reconstruye el frontend con la IP nueva.

Guía completa de instalación