VulkanoVM VulkanoVM
ES·EN Descargar
← Volver a VulkanoVM

Guía de instalación

Para instalaciones self-hosted (VM/imagen con licencia propia) — no aplica al servicio gestionado por RedTech.

¿Prefieres verlo en 4 pasos rápidos? Los tienes también en el propio formulario de descarga. Esta guía entra en el detalle de cada paso, incluyendo el acceso SSH opcional y cómo activar una licencia de pago.

1. Requisitos

No necesitas instalar Docker tú mismo ni tener acceso a ningún registro de imágenes: todo viene ya preparado dentro de la VM.

2. Restaurar la plantilla en tu Proxmox

El backup contiene una VM Debian ya preparada: Docker instalado, las imágenes de VulkanoVM ya cargadas, y un servicio que se encarga solo de generar los secretos y levantar el stack en el primer arranque. No necesitas entrar por SSH ni editar ningún fichero.

A. Subir el backup a tu Proxmox

Desde la interfaz web: Datacenter → (elige tu storage, p. ej. local) → Backups → Upload, y selecciona el fichero .vma.zst.

Por CLI, si tienes acceso SSH al nodo:

scp vulkanovm-*.vma.zst root@tu-proxmox:/var/lib/vz/dump/

B. Restaurar como VM nueva

En Backups, selecciona el fichero subido → Restore. Elige un VMID libre y el storage destino para el disco. Al terminar tendrás una VM nueva, apagada, lista para arrancar.

C. Arrancar y completar la configuración desde el navegador

Arranca la VM desde Proxmox. Espera un minuto largo (está generando contraseñas seguras, descargando un par de imágenes públicas de Docker Hub — nginx, postgres, redis, certbot, necesita salida a internet para esto — y levantando el stack, todo solo). Después, abre en tu navegador:

http://<IP-de-la-VM>/

Verás el asistente de primera configuración: te pide el email y contraseña que quieras para tu cuenta de administrador (y, si quieres, el dominio y servidor de correo — se puede dejar para más tarde). Al terminar, entras directamente con esas credenciales.

Sin licencia instalada, la instancia funciona en la Free tier: 1 datacenter, 1 clúster, 1 nodo, 1 tenant, 1 usuario y 5 VMs como máximo. Es plenamente funcional para evaluar el producto.

3. Acceso SSH de emergencia (opcional)

La plantilla no trae ningún usuario ni contraseña preconfigurados, y no lo necesita para el funcionamiento normal — todo el arranque y la configuración de la cuenta de administrador se hacen solos (ver sección 2). Esto es solo para si quieres poder entrar por SSH a mirar logs o depurar algo.

A. Usuario y acceso SSH

En la pestaña Cloud-Init de la VM, antes de arrancarla, rellena el campo SSH public key con tu clave pública.

⚠️ El campo Password de Cloud-Init no sirve para entrar por SSH — la imagen base trae el login por contraseña deshabilitado en el propio SSH (PasswordAuthentication no), por endurecimiento de fábrica. Si no pones una clave SSH, solo podrás entrar por la consola de Proxmox (noVNC), nunca por contraseña vía SSH.

El campo User es opcional — si lo dejas vacío, se usa debian por defecto. Tras guardar, Proxmox regenera el disco de Cloud-Init solo.

B. Ver el progreso del primer arranque

Una vez dentro (por SSH o por consola):

sudo systemctl status vulkanovm-firstboot
cd /opt/vulkanovm && sudo docker compose ps

C. IP de la VM

Por defecto usa DHCP — la IP la asigna el DHCP de tu red. Para verla una vez arrancada: pestaña Resumen de la VM en Proxmox, bajo "IPs" (el guest agent QEMU ya viene instalado y activado), o por CLI: qm guest cmd <vmid> network-get-interfaces. Si prefieres una IP fija, configúrala en la pestaña Cloud-Init antes del primer arranque.

D. Exponer la aplicación a internet (solo si no te basta con tu LAN/VPN)

Esto es responsabilidad de tu propia red — la plantilla no lo configura por ti:

Si solo vas a usarla dentro de tu LAN/VPN, sáltate este paso y accede directamente por la IP privada de la VM.

4. Activar una licencia de pago (Standard / Enterprise)

Todo esto se hace desde el navegador, sin SSH — panel de superadmin → Licencia.

  1. En esa pantalla verás tu Instance ID ya visible arriba del todo, con un botón para copiarlo. Envíaselo a RedTech al contratar tu licencia (es la huella única de tu instalación).
  2. RedTech te enviará el contenido de tu licencia.
  3. Pégalo en el cuadro "Instalar / actualizar licencia" de esa misma pantalla y dale a Instalar licencia. Se aplica al momento, sin reiniciar nada.

La licencia queda atada a ese Instance ID: pegarla en otra instalación no funciona, porque su Instance ID será distinto.

Si tu licencia caduca: durante el periodo de gracia indicado en la propia licencia, sigue funcionando exactamente igual, con los límites de tu plan. Pasado ese margen, la instancia bloquea todas las acciones (crear, editar, borrar, encender/apagar VMs, consola) hasta que instales una licencia nueva — pero puedes seguir viendo todo (paneles, listados, informes) y entrando a esta misma pantalla para renovarla. No se pierde ningún dato ni configuración mientras tanto.

5. Conectar tu Proxmox VE

VulkanoVM necesita un usuario y token de API dedicados en cada Proxmox VE que quieras gestionar — nunca uses tu usuario/contraseña personal.

A. Crear el usuario y el token

B. Crear un rol personalizado OrchestratorAdmin

Con estos privilegios mínimos:

C. Aplicar el permiso

En la ruta raíz (/) del clúster, con Propagar activado, para que alcance a todos los nodos y almacenamientos.

Nota: algunos clústeres Proxmox requieren "Privilege Separation" = OFF en el token para que estos permisos funcionen correctamente.

¿Algo no cuadra? Escríbenos a admin@vulkanovm.com.