Introducción
- Este artículo te guía a través de la creación y el alojamiento de una aplicación de Uptime Kuma en Square Cloud.
- Antes de comenzar, asegúrate de tener una cuenta en Square Cloud, que puedes crear en la página de registro con tu correo electrónico.
- Por último, necesitas tener un plan activo en tu cuenta. Compara los planes disponibles y elige uno según tus necesidades.
Eligiendo una versión
- Primero, elige una versión en nuestras releases de uptimekuma-web.
- Descarga el
project.zipde la versión elegida.
Archivo de configuración
- El proyecto ya incluye su archivo de configuración,
squarecloud.config. Si quieres un subdominio personalizado en lugar de un hash aleatorio, define en él el subdominio deseado:
squarecloud.config
También puedes establecer esto a través del menú de subida.
- No hay ningún puerto que configurar: Uptime Kuma lee las variables de entorno
PORTyHOST, que Square Cloud define como80y0.0.0.0.
Subiendo el Proyecto a Square Cloud
Después de preparar los archivos de tu proyecto, ya puedes subirlos a Square Cloud y alojar tu proyecto.A través del panel
1
Accede a la página de subida
Accede a la página de subida y sube el archivo zip de tu proyecto.
2
Configura tu entorno
Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.
3
Despliega tu proyecto
Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

4
Confirma que tu aplicación esté en vivo
Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre
Si desplegaste un sitio web o una API, abre
https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
A través de la CLI
Para usar este método, tu proyecto necesita un archivo de configuración llamadosquarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.
Guía del archivo de configuración
Aprende a crear el archivo de configuración
squarecloud.app que define el entorno de tu aplicación.1
Instala la CLI
Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:
2
Inicia sesión
Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.
3
Sube tu proyecto
Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista Para subir un zip que creaste tú mismo, pásalo con
squarecloud.ignore, y lo sube:--file:4
Confirma que tu aplicación esté en vivo
Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:Si desplegaste un sitio web o una API, abre
https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.
Creando la cuenta de administrador
Justo después del deploy, abrehttps://my-uptime-kuma.squareweb.app y crea la cuenta de administrador. Quien abra la página primero la crea, así que hazlo antes de compartir la URL con nadie.
Consideraciones finales
¡Eso es todo! Tu instancia de Uptime Kuma ya está en vivo enmy-uptime-kuma.squareweb.app, lista para que empieces a monitorear tus servicios.
Próximos pasos
Dominio personalizado
Sirve tus páginas de estado desde tu propio dominio.
n8n
Automatiza lo que ocurre cuando un monitor cae.
La app no inicia
Soluciona módulos que faltan, errores de memoria y otros fallos de inicio.

