Instalar o convertir un servidor

Un servidor se une a PlusPanel de una de estas tres formas:

Forma	Qué se ejecuta en el servidor	Estado
Imagen nativa (ISO, qcow2, nube)	PlusPanel OS desde el primer arranque	con la disponibilidad general
Conversión en el sitio	PlusPanel OS, en lugar de AlmaLinux o Rocky Linux, conservando los datos	disponible
Modo de compatibilidad	el agente de PlusPanel en tu AlmaLinux o Rocky Linux, tal como está	disponible

PlusPanel OS es el destino recomendado: un sistema inmutable y firmado que actualizamos por ti (cómo funcionan las actualizaciones). El modo de compatibilidad es la forma más rápida de empezar, y un servidor en modo de compatibilidad puede convertirse más adelante; no recibe de nosotros actualizaciones del sistema operativo.

Todas las formas empiezan en el panel: Servidores → Añadir servidor te da un comando de registro de un solo uso.

Requisitos

Necesitas
SO	AlmaLinux 9 o 10, Rocky Linux 9 o 10, x86_64 (conversión y modo de compatibilidad)
Máquina	un servidor dedicado o una máquina virtual con virtualización completa (KVM, VMware, Proxmox, Hyper-V, instancias en la nube). No contenedores OpenVZ, Virtuozzo o LXC
Recursos	al menos 2 GB de RAM, un disco de 20 GB con 6 GB libres
Disco	el sistema de archivos raíz (xfs o ext4) en una partición normal; /boot en él o en su propia partición. Sirven los esquemas predeterminados de Hetzner Cloud y de la mayoría de imágenes en la nube
Firmware	BIOS o UEFI con Secure Boot desactivado
Red	HTTPS saliente hacia registry.pluspanel.net y el plano de control, UDP 51820 saliente. Para la gestión no hace falta ningún puerto entrante
Acceso	root (o sudo) por SSH y una consola (consola de la nube, IPMI/KVM) por si más adelante quieres revertir a mano

Aún no compatibles con la conversión (la comprobación los rechaza y explica por qué): LVM, RAID por software (por ejemplo, el RAID predeterminado de dos discos de los servidores dedicados de Hetzner), discos cifrados, /var o /home separados, discos de datos adicionales en /etc/fstab, Secure Boot.

Convertir un servidor en su sitio

La conversión es la forma de tener PlusPanel OS en proveedores que no te dejan subir tu propia imagen, como Hetzner Cloud. El servidor conserva su lugar en tu panel y todas sus cuentas, con sus sitios, bases de datos y archivos. Es prudente por diseño:

• el sistema operativo actual se queda en el disco hasta que PlusPanel OS ha demostrado que funciona en tu servidor;
• el primer arranque de PlusPanel OS es una prueba: si el servidor no contacta con el plano de control en 10 minutos, vuelve por sí solo a tu sistema operativo actual, lo restaura y te dice por qué;
• no se reparticiona ni se reformatea nada, no se abre ningún puerto y solo se contacta con el registro y el plano de control de PlusPanel.

Haz antes una instantánea si tu proveedor lo permite. La conversión se revierte sola, pero una instantánea protege también los datos que PlusPanel no gestiona.

Qué cambia para ti: PlusPanel OS se gestiona solo desde el panel. No tiene SSH ni inicio de sesión: tu sesión SSH termina con el reinicio de la conversión. El software que instalaste tú con dnf, otros usuarios, las tareas cron y las reglas de firewall no se trasladan. Los datos propios de PlusPanel sí: la identidad del servidor y cada cuenta, con sus sitios, bases de datos, archivos y cuotas.

1. Comprueba el servidor

Ejecuta la comprobación con los valores de tu comando de registro (no se cambia nada):

curl -fsSL https://get.pluspanel.net/install.sh | sudo bash -s -- preflight --mode convert \
  --enroll-url https://… --token ppe1_…

Cada comprobación muestra ok, warn o FAIL, con una explicación para cada fallo. Añade --json para obtener un informe legible por máquinas (código de salida 0 = listo, 1 = no listo). Un servidor que ya ejecuta el agente en modo de compatibilidad conserva su identidad: omite --enroll-url y --token.

2. Revisa el plan

curl -fsSL https://get.pluspanel.net/install.sh | sudo bash -s -- convert --dry-run \
  --enroll-url https://… --token ppe1_…

El plan enumera exactamente qué se tocará (la partición de arranque y el gestor de arranque), qué se conserva y qué no. Todavía no se cambia nada.

3. Convierte

curl -fsSL https://get.pluspanel.net/install.sh | sudo bash -s -- convert \
  --enroll-url https://… --token ppe1_…

Opción
--channel stable|preview	canal de versiones (predeterminado stable)
--health-timeout SECONDS	cuánto espera el arranque de prueba al plano de control (120–3600, predeterminado 600)
--no-reboot	lo prepara todo y se detiene; reinicias tú cuando quieras, o lo deshaces con convert --abort
--yes	no pide confirmación

El instalador registra el servidor (si hace falta), descarga PlusPanel OS y comprueba su firma, lo instala junto al sistema operativo actual, traslada los datos de PlusPanel y reinicia. Tus sitios dejan de estar disponibles desde ese momento hasta que PlusPanel OS los vuelve a arrancar, normalmente unos minutos.

4. Síguelo en el panel

En Servidores, el sistema operativo pasa de Modo de compatibilidad · AlmaLinux 9.x a PlusPanel OS · versión en cuanto el servidor informa desde PlusPanel OS. No hace falta nada más.

Si algo sale mal

El servidor vuelve por sí solo a su sistema operativo anterior cuando PlusPanel OS no contacta con el plano de control durante el arranque de prueba, o no llega a arrancar. Después se restaura por completo (gestor de arranque, datos, sin rastro de PlusPanel OS) y el panel vuelve a mostrar Modo de compatibilidad, con todas las cuentas funcionando. Por SSH ves el motivo:

sudo cat /var/lib/pluspanel-convert/result     # OUTCOME=rolled_back, REASON=…
cat /etc/motd.d/pluspanel-convert

Corrige la causa (normalmente el acceso saliente al plano de control) y vuelve a ejecutar la conversión.

Para volver atrás tú mismo tras una conversión correcta, abre la consola del servidor, reinícialo y elige “Previous OS: … (PlusPanel rollback)” en el menú de arranque (aparece durante un segundo: mantén pulsado Esc o Shift mientras arranca el servidor). El sistema operativo anterior se restaura de la misma manera. Esto funciona hasta que el sistema operativo anterior se limpia del disco.

Antes del reinicio (con --no-reboot) puedes deshacerlo todo:

curl -fsSL https://get.pluspanel.net/install.sh | sudo bash -s -- convert --abort