Cómo realizar tu primer despliegue vía Dashboard (Paso a paso)

Requisitos previos

Antes de iniciar el proceso en el Dashboard, asegúrate de tener:

Una cuenta activa y validada en Square Cloud.
Un plan con recursos suficientes (RAM/CPU) para tu aplicación.
El código de tu aplicación finalizado y probado localmente.

1. Preparando tu proyecto

Para que Square Cloud entienda y ejecute tu proyecto correctamente, debes asegurarte de que la estructura de los archivos sea la adecuada.

El archivo de configuración (`squarecloud.app`)

Este es el paso más importante. Todo proyecto debe tener un archivo llamado squarecloud.app en la carpeta raíz. Este indica cómo debe manejar la infraestructura tu código.

Aunque nuestra plataforma cuenta con un sistema inteligente de creación automática de configuraciones vía dashboard, nada te impide ejercer tu lado 'power user'. Si prefieres anticiparte y configurar los archivos manualmente, siéntete libre de hacerlo: ¡apreciamos e incentivamos ese nivel de esmero técnico! 😉

Ejemplo básico de un squarecloud.app para Node.js:

DISPLAY_NAME=Mi Primer App
DESCRIPTION=Una aplicación increíble ejecutándose en Square Cloud
MAIN=index.js
MEMORY=512
VERSION=recommended

Archivos de dependencias

Asegúrate de que el archivo que lista las librerías de tu proyecto esté en la raíz:

Node.js: package.json
Python: requirements.txt
Java: pom.xml o build.gradle

Básicamente, recuerda mantener el archivo de dependencias correspondiente a tu entorno de ejecución (runtime) seleccionado.

2. Comprimiendo los archivos (.zip)

El Dashboard acepta la carga de proyectos en formato .zip. Para garantizar que el archivo se genere correctamente:

Selecciona todos los archivos de la raíz de tu proyecto (incluyendo el squarecloud.app, tu archivo principal y los archivos de dependencias).
Haz clic derecho y selecciona la opción de comprimir o zipear.
Atención: Comprime los archivos, no la carpeta que los contiene. Si abres el .zip, debes ver el código inmediatamente, y no una única carpeta raíz.
Qué NO incluir en el .zip: Evita enviar carpetas pesadas de dependencias generadas localmente, como node_modules (Node.js), venv (Python) o archivos ocultos pesados como la carpeta .git. Square Cloud instalará las dependencias automáticamente durante el despliegue.

3. Realizando la carga en el Dashboard

Con tu archivo .zip listo, es hora de enviar el proyecto a la plataforma.

Accede al Dashboard de Square Cloud e inicia sesión.
En la pantalla inicial, localiza el botón "New Application" (Nueva Aplicación) o el área de carga.
Haz clic para seleccionar el archivo en tu computadora o simplemente arrastra y suelta tu archivo .zip en el área indicada.
Espera a que la barra de progreso se complete. El tiempo varía según el tamaño de tu proyecto y tu conexión a internet.

4. Siguiendo el Build y los Logs

Tan pronto como se complete la carga, Square Cloud iniciará automáticamente el proceso de build (construcción) de tu entorno.

Serás redirigido a la página de gestión de tu aplicación.
Accede a la pestaña "Logs" (o Terminal).
Sigue los mensajes en pantalla. Verás cómo la plataforma descarga tus dependencias (ej: ejecutando npm install o pip install) y, luego, inicia tu archivo principal.
Si tu código se ejecuta sin errores, verás el mensaje de éxito en la terminal, indicando que la aplicación está Online.

¿Surgió algún error?

La gran mayoría de los errores en el primer despliegue están relacionados con la ausencia del archivo squarecloud.app, errores de sintaxis dentro de este, o con que el .zip se haya comprimido de forma incorrecta (comprimiendo la carpeta en lugar de los archivos). Revisa los pasos anteriores o consulta la Documentación Oficial para obtener más detalles sobre tu lenguaje de programación específico.

Actualizado el: 08/06/2026

¿Este artículo te resultó útil?

¡Gracias!