Inicio rápido: haz deploy de tu primera app

Esta guía hace deploy de un pequeño servidor web en Node.js para que veas todo el flujo de principio a fin: tres archivos, un zip y una subida. Los pasos son los mismos para un bot o para otro lenguaje.

Antes de empezar

Square Cloud es una plataforma de pago: se requiere un plan activo para desplegar, así tu proyecto corre sobre infraestructura de nivel producción desde el primer día. Crea tu cuenta, luego selecciona el plan que mejor se adapte a ti (consulta qué incluye cada plan).

Registrarse

Si nunca has usado Square antes, regístrate para comenzar.

Iniciar sesión

Si ya tienes una cuenta, inicia sesión para comenzar.

Crea el proyecto

Crea una carpeta con estos tres archivos.

Escribe la app

index.js responde a cada solicitud con un mensaje corto. Lee el puerto y el host de las variables de entorno PORT y HOST, que Square Cloud define como 80 y 0.0.0.0:

index.js

const http = require("node:http");

const port = process.env.PORT || 3000;
const host = process.env.HOST || "0.0.0.0";

http
  .createServer((req, res) => {
    res.writeHead(200, { "Content-Type": "text/plain" });
    res.end("Hello from Square Cloud!");
  })
  .listen(port, host, () => {
    console.log(`Listening on http://${host}:${port}`);
  });

Lista las dependencias

Todo proyecto de Node.js necesita un package.json: Square Cloud instala los paquetes que lista antes de iniciar tu app. Este ejemplo no tiene ninguno, pero el archivo debe existir y no puede estar vacío.

package.json

{
  "name": "hello-square",
  "version": "1.0.0",
  "private": true,
  "main": "index.js",
  "scripts": {
    "start": "node index.js"
  }
}

Agrega el archivo de configuración

squarecloud.app le indica a Square Cloud qué archivo ejecutar, cuánta memoria reservar y qué versión del runtime usar. SUBDOMAIN publica la app como un sitio web en https://<subdomain>.squareweb.app, así que elige un nombre que nadie haya tomado todavía.

squarecloud.app

MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Hello Square
SUBDOMAIN=hello-square-yourname

Cada campo se explica en la referencia del archivo de configuración. La extensión de VS Code autocompleta y valida este archivo mientras escribes.

Un sitio web debe escuchar en el puerto 80 y en el host 0.0.0.0. Un servidor enlazado a localhost, 127.0.0.1 o a otro puerto (como 3000 u 8080) no es accesible, y el sitio muestra una página de timeout. Leer PORT y HOST, como hace index.js, lo resuelve en Square Cloud y sigue funcionando en el puerto 3000 en tu máquina.

¿Vas a hacer deploy de un bot? Quita SUBDOMAIN, agrega AUTORESTART=true y guarda el token en una variable de entorno, nunca en el código. El tutorial de bots de Discord recorre un bot completo.

Comprime el proyecto

¿Vas a hacer deploy con la CLI? Sáltate esta sección: squarecloud upload comprime la carpeta por ti.

Selecciona los archivos, no la carpeta

Abre la carpeta del proyecto y selecciona todo lo que contiene. squarecloud.app debe quedar en el nivel superior del zip: si comprimes la carpeta en sí, los archivos terminan dentro de una subcarpeta y el deploy falla con MISSING_CONFIG.

Crea el zip

Windows
macOS
Linux

Haz clic derecho en los archivos seleccionados y elige Comprimir en archivo ZIP (Windows 11) o Enviar a → Carpeta comprimida (en zip).

Haz clic derecho en los archivos seleccionados y elige Comprimir, o ejecuta zip -r ../app.zip . dentro de la carpeta.

Revisa el tamaño

El zip puede pesar hasta 100 MB. Deja fuera node_modules, los entornos virtuales y las cachés de build: las dependencias se instalan en el servidor, y esas carpetas se eliminan en el deploy de todos modos.

Haz deploy

Sube el zip en el dashboard, o haz deploy con un solo comando desde la CLI.

A través del panel

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

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.

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.

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 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.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

A través de la CLI

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.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.

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

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.

squarecloud auth login

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 squarecloud.ignore, y lo sube:

squarecloud upload

Para subir un zip que creaste tú mismo, pásalo con --file:

squarecloud upload --file <path/to/zip>

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:

squarecloud app status
squarecloud app logs

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.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

Cuando la app esté en ejecución, https://hello-square-yourname.squareweb.app (con tu subdominio) responde Hello from Square Cloud!.

¿Quieres un deploy en cada push? Conecta un repositorio de GitHub o usa el workflow de GitHub Actions.

Próximos pasos

Archivo de configuración

Cada campo de squarecloud.app: memoria, comando de inicio, subdominio y reinicios automáticos.

Variables de entorno

Guarda tokens y cadenas de conexión fuera de tu código.

Solución de problemas

Corrige errores de subida, sitios que no cargan y apps que no inician.

Extensión de VS Code

Sube, haz commit y sigue los logs sin salir de tu editor.

Guías para tu lenguaje

Cada guía cubre el archivo de dependencias, el comando de inicio y los errores comunes de su runtime.

Servicios

Solución de problemas

Runtimes

Plataforma

Changelog

Inicio rápido: haz deploy de tu primera app

Antes de empezar

Registrarse

Iniciar sesión

Crea el proyecto

Comprime el proyecto

Haz deploy

A través del panel

A través de la CLI

Guía del archivo de configuración

Próximos pasos

Archivo de configuración

Variables de entorno

Solución de problemas

Extensión de VS Code

Guías para tu lenguaje

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

​Antes de empezar

Registrarse

Iniciar sesión

​Crea el proyecto

​Comprime el proyecto

​Haz deploy

​A través del panel

​A través de la CLI

Guía del archivo de configuración

​Próximos pasos

Archivo de configuración

Variables de entorno

Solución de problemas

Extensión de VS Code

​Guías para tu lenguaje

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS

Antes de empezar

Crea el proyecto

Comprime el proyecto

Haz deploy

A través del panel

A través de la CLI

Próximos pasos

Guías para tu lenguaje