Cómo instalar Cloudron en un VPS con Ubuntu
Instala Cloudron en un VPS Ubuntu nuevo con DNS comodín, script de instalación y primer arranque. Incluye requisitos, recursos para 2 a 10 apps, correo y copias.
Instalar Cloudron en un VPS: versión breve
Para instalar Cloudron en un VPS necesita un servidor Ubuntu nuevo, al menos 2 GB de RAM y un dominio cuyos registros DNS pueda editar. La instalación se realiza con tres comandos y un reinicio. Casi todos los problemas aparecen antes de ese paso (imagen base incorrecta o tipo de virtualización incorrecto) o después (DNS, correo y copias de seguridad).
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupCloudron instala, actualiza y realiza copias de seguridad de aplicaciones autoalojadas. También emite certificados TLS (seguridad de la capa de transporte). Cada aplicación se ejecuta en Docker y nginx se sitúa delante de todas ellas. Cada aplicación obtiene su propio subdominio del dominio. Por eso la configuración de DNS es el primer paso.
Por qué Cloudron es exigente con el sistema operativo base
El script de instalación comprueba el servidor antes de instalar nada. Si una comprobación falla, tendrá que contratar otro servidor. Lea estos requisitos antes de elegir una imagen. Las comprobaciones del instalador citadas en esta sección corresponden al 13 de octubre de 2026; la documentación de instalación actual solicita un servidor Ubuntu 26.04 nuevo.
- Sólo Ubuntu y sólo tres versiones. Cualquier otra opción termina con
Cloudron requires Ubuntu 22.04, 24.04, 26.04. Ubuntu 20.04 se rechaza y la documentación de instalación ahora solicita un servidor Ubuntu 26.04 nuevo. Debian, Rocky y Alpine no son compatibles. Ubuntu 24.04 necesita Cloudron 8 o una versión posterior, y el script lo comprueba automáticamente. - Sólo Intel o AMD de 64 bits:
Error: Cloudron only supports amd64/x86_64. No se puede ejecutar en un VPS ARM. - Sólo virtualización completa del hardware. En un VPS basado en contenedores, el script se detiene con
Error: Cloudron does not support lxc, only runs on bare metal or with full hardware virtualizationporque detecta el contenedor mediantesystemd-detect-virt --container. KVM es compatible. OpenVZ y LXC no lo son. - El sistema de archivos raíz debe ser
ext4oxfs. Con cualquier otro sistema se obtieneError: Cloudron requires '/' to be ext4 or xfs. Así es como fallan las imágenes btrfs y zfs. - Al menos 941 MB de RAM, medidos con
free -m, y 18 GB en/, medidos como el tamaño del sistema de archivos raíz. El mensaje de error solicita 20GB, pero la comprobación acepta un sistema de archivos raíz de 19 GB. - Un servidor realmente nuevo. Si
nginx,dockeronodeya está instalado, el script lo rechaza conError: Some packages like nginx/docker/nodejs are already installed.
Esta última comprobación suele generar discusiones, así que conviene explicar el motivo. Cloudron instala versiones fijadas de Docker, nginx, Node.js y MySQL, escribe la configuración de nginx para cada aplicación que aloja y administra por sí mismo las reglas del firewall de iptables. Un Docker que instaló ayer tendría una versión incorrecta. Por eso el script termina sin modificar nada y le indica que empiece con una instalación nueva de Ubuntu. Cloudron controla toda la máquina, así que debe asignarle un VPS dedicado.
Es fácil pasar por alto otra comprobación. En una CPU antigua sin AVX (advanced vector extensions), el script muestra CPU has no AVX support. MongoDB will be disabled y todas las aplicaciones que necesitan MongoDB dejan de poder instalarse. Compruebe la CPU antes de comprometerse con grep -m1 -o avx /proc/cpuinfo. En un host compatible, este comando muestra avx; en uno antiguo no muestra nada.
¿Cuánta RAM necesita Cloudron?
La comprobación del instalador del 13 de octubre de 2026 no se ejecutaba con menos de 941 MB, con Error: Cloudron requires atleast 1GB physical memory; la documentación actual solicita 2 GB de RAM y 20 GB de disco. Ambas cifras son el mínimo de la plataforma, no el mínimo de la plataforma más sus aplicaciones. Cloudron ejecuta Docker, nginx, su propio servicio box y la pila de correo, y aprovisiona servicios de base de datos compartidos a medida que se despliegan las aplicaciones. Ejecute docker ps en una instalación nueva y cuéntelos.
Los límites de memoria de las aplicaciones se suman a esa base. Cada paquete de aplicación incluye un límite predeterminado bajo, que puede aumentarse con el control deslizante de la vista Resources de la aplicación. Cuando una aplicación supera su límite, se reinicia y envía una notificación OOM (sin memoria). Por tanto, un servidor que reinicia continuamente una aplicación suele tener un problema de límites, no un error del software.
Este es el dimensionamiento que recomendaría. Son recomendaciones para un servidor que no tendrá que reinstalar el próximo mes. No son resultados de pruebas comparativas medidas.
Los datos de este gráfico
[
{
"label": "2 apps (free tier)",
"vcpu": 2,
"ram_gb": 4,
"disk_gb": 60
},
{
"label": "5 apps",
"vcpu": 4,
"ram_gb": 8,
"disk_gb": 120
},
{
"label": "10 apps",
"vcpu": 6,
"ram_gb": 16,
"disk_gb": 240
}
]Dos aplicaciones funcionan cómodamente con 4 GB de RAM y 60 GB de disco. Unas diez aplicaciones necesitan 16 GB y 240 GB, porque la base de la plataforma nunca se reduce y cada aplicación añade una imagen de Docker, una base de datos y sus propios datos. El disco se llena más rápido de lo esperado: las imágenes, los datos de las aplicaciones y las copias de seguridad locales comparten un volumen hasta que las copias de seguridad se trasladan fuera del servidor.
Cloudron proporciona swap ilimitada a cada aplicación, por lo que el límite de memoria configurado se aplica sólo a la RAM. En una imagen de VPS sin archivo de swap, swapon --show no muestra nada y la presión de memoria se convierte directamente en reinicios OOM en lugar de ralentizar la aplicación. Añadir 2 GB de swap es una medida de bajo coste, aunque no sustituye a la memoria real. La diferencia entre los planes de VPS es pequeña frente a las horas que dedicará a ajustar los límites; consulte cuánto cuesta realmente un VPS y compre el siguiente tamaño.
DNS: el registro comodín que hace funcionar los subdominios de las aplicaciones
Cloudron coloca el panel en my.example.com y cada aplicación en su propio subdominio, por lo que DNS es un requisito previo, no un paso posterior. Apunte estos registros a la dirección IP pública del servidor antes de abrir el panel por primera vez:
my.example.comcomo registro A. Este es el panel.*.example.comcomo registro A. Este es el registro que hace funcionar los subdominios de las aplicaciones, por lo quewiki.example.comygit.example.comresolverán en cuanto instale esas aplicaciones.example.comcomo registro A, sólo si quiere una aplicación en el dominio raíz.
Un registro comodín tiene menor prioridad que un registro explícito, por lo que un www.example.com existente que apunte a otro destino seguirá funcionando.
Durante la configuración, elija cómo gestionará Cloudron DNS a partir de ese momento:
- Un proveedor con API. Cloudron almacena un token de Cloudflare, DigitalOcean, Route53, Hetzner, Porkbun, Linode, deSEC, Gandi, Namecheap, Hostinger DNS, Scaleway DNS y otros (22 integraciones de DNS mediante API en total, sin incluir Wildcard, Manual y No-op), y después escribe todos los registros por sí mismo, incluidos los registros de correo.
- Wildcard. Añade manualmente el registro
*y Cloudron no escribe nada. - Manual. Cloudron muestra cada registro y espera mientras lo añade, antes de cada instalación de una aplicación.
Un registro DNS comodín no es un certificado comodín. El proveedor de certificados predeterminado es Let's Encrypt Prod - Wildcard, que demuestra la propiedad mediante DNS, por lo que sólo funciona con un proveedor con API. En los backends Wildcard o Manual, Let's Encrypt emite certificados individuales validados mediante HTTP, lo que requiere el puerto entrante 80 para la emisión y la renovación. Puede desactivar la integración con Let's Encrypt y cargar un certificado comodín personalizado, de modo que el puerto 80 no sea un requisito permanente para validar certificados. Si su registrador o proveedor de DNS aparece en la lista de API, utilícelo: los registros de correo y los certificados dejarán de ser responsabilidad suya.
Verifique los registros antes de continuar. dig +short my.example.com y dig +short anything.example.com deberían mostrar la dirección IP de su servidor. En el backend Wildcard, si la consulta del comodín no muestra nada, las aplicaciones fallarán más adelante aunque el panel funcione correctamente.
Si el dominio está detrás de Cloudflare, configure los registros como DNS only. El proxy sólo reenvía HTTP y HTTPS, por lo que los puertos de correo dejan de funcionar. Para las aplicaciones web que usan proxy, la vista Network de Cloudron permite confiar en los rangos de IP publicados por Cloudflare para recuperar la dirección del visitante a partir de las cabeceras reenviadas.
Ejecute el script de instalación
wget https://cloudron.io/cloudron-setup
chmod +x cloudron-setup
sudo ./cloudron-setupEjecútelo como root o mediante sudo, porque, de lo contrario, lo primero que muestra es This script should be run as root.. La instalación tarda varios minutos y no muestra actividad mientras se ejecuta, porque la salida de apt y las descargas de Docker se escriben en un archivo de registro. Supervise el registro desde una segunda sesión SSH:
tail -f /var/log/cloudron-setup.logEn la comprobación del instalador del 13 de octubre de 2026, mostró After reboot, visit one of the following URLs and accept the self-signed certificate to finish setup. seguido de la dirección del servidor y, después, preguntó The server has to be rebooted to apply all the settings. Reboot now ? [Y/n]. Responda afirmativamente. Ese instalador también proporcionaba la opción --skip-reboot para posponer el reinicio.
Primer arranque: dominio, backend DNS y cuenta de administración
Abra https://<server-ip> y acepte la advertencia del navegador. El certificado es autofirmado porque Cloudron aún no conoce su dominio y, por tanto, no tiene ningún certificado que solicitar a una autoridad certificadora. En Chrome, haga clic en Advanced y después en Proceed to <ip> (unsafe). En Firefox, haga clic en Advanced y después en Accept the Risk and Continue.
La primera pantalla solicita su dominio. Introduzca example.com y el panel quedará disponible en my.example.com. También puede usar un subdominio, como cloudron.example.com, y el panel estará disponible en my.cloudron.example.com. Seleccione el backend DNS, pegue el token de API si dispone de uno y cree la cuenta de administración con una dirección de correo electrónico que consulte habitualmente: los restablecimientos de contraseña y las notificaciones de la plataforma se envían a esa dirección.
Al guardar, Cloudron solicita los certificados y mueve el panel a https://my.example.com. La URL basada en la dirección IP deja de funcionar en ese momento, así que añada la nueva a sus marcadores.
Certificados: qué se renueva y cuándo deja de funcionar
La renovación de certificados es automática y sigue ACME Renewal Information (ARI), el calendario que publica la entidad certificadora. En la práctica, renueva aproximadamente un mes antes de la caducidad. Si la renovación falla, se envía un correo electrónico a la cuenta de administración y el certificado caducado se sustituye por el certificado autofirmado integrado. Esto es lo que significa realmente la advertencia del navegador en un sitio que funcionaba el día anterior.
Dos causas explican la mayoría de los casos. La validación HTTP necesita el puerto de entrada 80. Por tanto, cerrar el puerto 80 porque «todo usa HTTPS de todos modos» interrumpe la renovación de las aplicaciones que usan la validación HTTP de Let's Encrypt con un backend Wildcard o Manual DNS. La validación DNS necesita un token de API que conserve el acceso de escritura. Rotar o restringir ese token interrumpe la renovación sin mostrar errores hasta que llega el correo de advertencia.
La vista Domains tiene un botón Renew All para forzar el intento inmediatamente y un proveedor Let's Encrypt Staging para realizar pruebas. Los certificados de Staging no son de confianza para los navegadores de forma intencionada. Ese es precisamente el objetivo: las pruebas evitan consumir los límites de producción. Staging tiene sus propios límites, incluidos 200 fallos de autorización por identificador, por cuenta y por hora.
¿Debe usar el servidor de correo integrado?
Cloudron incluye una pila de correo completa con buzones IMAP, envío mediante submission, filtros Sieve y firma DKIM (DomainKeys Identified Mail). Se habilita por dominio en Email, dentro del panel. La parte difícil es conseguir que los mensajes se entreguen, y ninguna de esas dificultades depende de Cloudron.
- La mayoría de los proveedores de VPS bloquean el puerto saliente 25 para controlar el spam. Algunos lo desbloquean después de abrir un ticket de soporte. Pruebe desde el servidor con
nc -zv aspmx.l.google.com 25(instalenetcat-openbsdsi falta el comando). Los puertos abiertos muestransucceeded, y un puerto bloqueado queda esperando hasta que se agota el tiempo de espera. - El registro PTR (DNS inverso) lo configura el proveedor de VPS, no el proveedor de DNS. Debe coincidir con el nombre de host de correo cuando envía directamente desde el servidor. Un smart host elimina este requisito del PTR.
- Los registros SPF, DKIM y DMARC se escriben automáticamente en un backend de DNS con API. En los backends Wildcard o Manual debe añadirlos manualmente. Si falta el registro DKIM, no se puede verificar ningún mensaje que firme.
La configuración que funciona para la mayoría es recibir el correo en Cloudron y enviarlo mediante un relay como SendGrid, Postmark, Mailgun o Amazon SES, configurado en la vista Email. El relay debe permitir el envío como cualquier dirección de su dominio. De lo contrario, rechazará las notificaciones de aplicaciones enviadas desde distintas direcciones. Si el correo es el motivo principal por el que compra el servidor, ejecute un servidor de correo dedicado, como Mailcow en otro equipo, con su propia reputación de IP.
Si no usa Cloudron Email, bloquee los puertos 25, 465, 587, 993 y 4190 en el firewall del proveedor. Hágalo allí y no en el servidor, porque Cloudron escribe las reglas de iptables por sí mismo y espera administrarlas. Esto es lo contrario de un VPS convencional, donde usted administra las reglas de ufw.
Configura el destino de las copias de seguridad antes de necesitarlo
De forma predeterminada, las copias de seguridad se guardan en el sistema de archivos local, en /var/backups, en el mismo disco que el resto. La documentación lo indica claramente: «Tener las copias de seguridad en el mismo disco físico que el servidor de la plataforma es peligroso». Un fallo del disco afecta a las aplicaciones y a las copias de seguridad al mismo tiempo.
Abra Backups, después Backup Sites, y configúrelo para que use otro destino desde el primer día. El almacenamiento de objetos compatible con S3 suele ser la opción habitual (Backblaze B2, Wasabi, Cloudflare R2, DigitalOcean Spaces o un bucket de MinIO en un segundo servidor). También se admiten destinos SSHFS, NFS, CIFS y de sistema de archivos convencional.
Tres opciones determinan si esa copia de seguridad resulta útil:
- Formato.
tgzescribe un archivo comprimido por aplicación y vuelve a cargarlo completo en cada ejecución.rsynccarga sólo los archivos modificados, lo que resulta mucho más económico para un Nextcloud grande, pero genera muchas más peticiones a la API de almacenamiento. - Cifrado. AES-256 opcional que protege tanto el contenido de los archivos como sus nombres. Cloudron no conserva una copia de la contraseña. Si la pierde, nadie podrá descifrar las copias de seguridad, incluido usted. Guárdela en un gestor de contraseñas autohospedado antes de hacer clic en guardar.
- Retención. Se expresa mediante cantidades, como 7 copias diarias y 4 semanales. Una retención prolongada en el almacenamiento de objetos se factura cada mes, así que elija una cantidad cuyo coste esté dispuesto a seguir pagando.
Después, pruebe una restauración. Instale una aplicación pequeña, restáurela desde el panel y compruebe que vuelve a estar disponible con sus datos. Una copia de seguridad que nunca se ha restaurado es sólo una suposición.
Qué limita el plan gratuito
En octubre de 2026, el plan gratuito está limitado a dos aplicaciones instaladas. Incluye todo lo demás: actualizaciones de las aplicaciones, copias de seguridad por aplicación, el firewall, el servidor de correo y el inicio de sesión único. La tercera aplicación es el punto en el que se necesita una licencia. Los planes de pago eliminan el límite de aplicaciones, y el plan superior añade grupos y roles de usuarios, un servidor de directorio y varios sitios de copias de seguridad. Los precios cambian, así que consulte la página de precios de Cloudron en lugar de usar una cifra de un tutorial.
Una licencia cubre una instalación de Cloudron, por lo que dos servidores pequeños cuestan el doble que un servidor grande. Este modelo de precios lleva a la mayoría de usuarios a utilizar un único VPS más grande, lo que contradice el consejo habitual de distribuir los servicios entre varias máquinas. Dimensione el servidor teniendo esto en cuenta, ya que dividirlo más adelante implica pagar el doble.
Cuando algo falla
Empiece con la comprobación integrada. Revisa DNS, certificados, disco, memoria y cada servicio por turnos, e indica qué prueba ha fallado:
sudo cloudron-support --troubleshootDespués, use las herramientas habituales de systemd (el gestor del sistema y de servicios). systemctl status box informa sobre el propio servicio de Cloudron, journalctl -u box -n 100 muestra sus registros recientes y journalctl -u docker cubre el runtime de contenedores subyacente. Todo lo que haya fallado durante la instalación queda registrado en /var/log/cloudron-setup.log.
Si un panel no carga, normalmente el problema está en DNS o en el firewall del proveedor, no en Cloudron. Ejecute dig +short my.example.com desde su portátil y confirme que los puertos 80 y 443 estén abiertos en el firewall de red del proveedor. Es un control independiente de las reglas del propio servidor. En la comprobación del instalador del 13 de octubre de 2026, un segundo intento fue rechazado con Error: Cloudron is already installed. To reinstall, start afresh. La solución correcta es reconstruir el servidor.
Cuando Cloudron no es la opción adecuada
Cloudron encaja cuando quiere aplicaciones y no infraestructura. Encaja mal cuando quiere ejecutar sus propios contenedores de la forma que prefiera, porque controla nginx, Docker y el firewall, y sobrescribe lo que configure allí. Si su plan consiste en una carpeta de archivos Compose, Traefik delante de sus propias pilas de Docker Compose ofrece el mismo TLS automático y el enrutamiento por subdominios, sin una plataforma adicional. Si todavía no ha elegido, comparación entre Cloudron, CasaOS y Coolify los presenta lado a lado, y la lista más amplia de opciones para alojar por cuenta propia es un mejor punto de partida que una guía de instalación.
FAQ
¿Cuánta RAM necesita Cloudron en un VPS?
La comprobación del instalador del 13 de octubre de 2026 rechazó la ejecución con menos de 941 MB. La documentación actual solicita 2 GB, pero esa es la cantidad mínima para la plataforma sin aplicaciones instaladas. Cloudron ejecuta Docker, nginx, su propio servicio box y la pila de correo. También aprovisiona servicios de bases de datos compartidos cuando se implementan aplicaciones. Reserve 4 GB para dos aplicaciones y 16 GB para unas diez. Añada un archivo de swap, porque Cloudron permite que las aplicaciones usen swap sin límite y un sistema sin swap convierte la presión de memoria en reinicios.
¿Puedo instalar Cloudron en Debian o en un servidor que ya ejecuta Docker?
Ninguna de las dos opciones funciona. En la comprobación del instalador del 13 de octubre de 2026, el script se detuvo con versiones no compatibles mediante Cloudron requires Ubuntu 22.04, 24.04, 26.04 y rechazó servidores que ya tenían nginx, docker o node. La documentación de instalación actual requiere una imagen de Ubuntu limpia y excluye Debian, Rocky y Alpine. Empiece con una imagen de Ubuntu limpia en un VPS KVM.
¿Por qué fallan los subdominios de mis aplicaciones mientras el panel funciona?
En el backend Wildcard, compruebe el registro DNS comodín. La configuración crea o requiere un registro A para my.example.com. Por eso el panel resuelve, mientras wiki.example.com devuelve NXDOMAIN y el navegador indica que no se puede encontrar el sitio. Añada un registro A para *.example.com que apunte a la IP del servidor. Después, confírmelo con dig +short wiki.example.com antes de instalar la aplicación.
¿Tengo que usar el servidor de correo de Cloudron?
No. Puede desactivar el correo entrante y enviar mediante un relay externo, como Postmark, Mailgun o Amazon SES. Es la opción más segura si su proveedor bloquea el puerto saliente 25 o si la dirección IP no tiene reputación de correo. Si omite Cloudron Email por completo, cierre los puertos 25, 465, 587, 993 y 4190 en el firewall del proveedor, no en el servidor.
¿Qué ocurre cuando alcanzo el límite de dos aplicaciones del plan gratuito?
Necesita una suscripción de pago para instalar una tercera aplicación. Las aplicaciones que ya ejecuta no se modifican: siguen actualizándose, siguen incluyendo copias de seguridad y conservan sus certificados. Añadir una suscripción elimina el límite sin reinstalar nada. Por tanto, el plan gratuito permite probar la plataforma de forma adecuada en un dominio real.