Saltar al contenido principal
El runtime de Node.js ejecuta bots, APIs y sitios web renderizados en el servidor escritos en JavaScript y TypeScript. Square Cloud instala tus dependencias desde package.json e inicia tu app con Node.js.

​
Antes de empezar

  • Node.js y npm en tu máquina. Si no los tienes, descárgalos desde el sitio web oficial de Node.js.
  • Una cuenta de Square Cloud: regístrate con tu email o GitHub.
  • Un plan activo. Consulta los planes y elige el que se ajuste a tu proyecto.

​
Configurar Square Cloud

Si subes tu aplicación a través del dashboard, puedes omitir esta sección: el dashboard crea el archivo de configuración squarecloud.app por ti.

Referencia del archivo de configuración

El archivo squarecloud.app le indica a Square Cloud cómo ejecutar tu aplicación: su archivo principal, la memoria, la versión del runtime, el nombre y, para un sitio web, su subdominio.
Un archivo de configuración completo para cada tipo de app:
squarecloud.app
VERSION=recommended ejecuta la línea LTS actual de Node.js, y VERSION=latest la versión más reciente.

​
Qué ejecuta Square Cloud

  • Si el campo START no está definido en el archivo de configuración, Square Cloud ejecuta node MAIN. Cuando la app tiene 1024 MB de memoria o más, añade --max_old_space_size=<MEMORY> (el límite del heap de Node.js, en MB). Si el campo START está definido, el valor que contenga se ejecutará directamente. Para obtener más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.
  • Si la app no tiene una carpeta node_modules, Square Cloud ejecuta npm install --no-audit --no-fund antes de iniciarla. Los paquetes de devDependencies no se instalan, porque el runtime define NODE_ENV=production. Cuando node_modules ya existe, se omite el paso de instalación.

​
Puerto y host para sitios web y APIs

Square Cloud define la variable de entorno PORT como 80 y HOST como 0.0.0.0. Tu servidor debe escuchar en ese puerto y en todas las interfaces de red, por ejemplo con Express:
Next.js, Nuxt, React Router, Astro y SolidStart leen PORT por sí mismos: sus guías de frameworks indican cuándo no hay nada que cambiar.

​
Preparar el proyecto

​
Archivos necesarios

  • squarecloud.app, en la raíz del ZIP.
  • Tu archivo principal, por ejemplo index.js o src/index.ts.
  • package.json, con tus dependencias. Una subida sin él falla con INVALID_DEPENDENCY.
El archivo de configuración (squarecloud.app) debe ubicarse en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.
Square Cloud ejecuta TypeScript de forma nativa con tsx (npx tsx MAIN), pero compilar a JavaScript sigue siendo lo recomendado en producción: compílalo en tu máquina y apunta MAIN al archivo compilado.

​
Qué dejar fuera

  • node_modules: Square Cloud elimina esta carpeta de tu subida e instala las dependencias desde package.json en el primer inicio. Así la subida es pequeña y las dependencias se compilan para el sistema del servidor.
  • Archivos de bloqueo (package-lock.json, yarn.lock, pnpm-lock.yaml): la CLI y la extensión de VS Code los dejan fuera por defecto, así que npm instala las versiones más recientes que permiten los rangos de package.json. Cuando necesites las versiones exactas de tu archivo de bloqueo, vuelve a incluirlo con !package-lock.json en tu squarecloud.ignore.

​
Guías de frameworks

Express

Fastify

NestJS

Next.js

Nuxt

React Router

Angular

Astro

SolidJS

Qwik

React

Vue

Las aplicaciones de página única compiladas con Vite, React, Vue o Preact también pueden funcionar sin Node.js, en el runtime estático.

​
Solución de problemas

Este error ocurre cuando el archivo definido como “main” para tu aplicación en el archivo de configuración no existe, está escrito incorrectamente o la ruta es incorrecta. Si tu archivo principal está dentro de una carpeta, por ejemplo, debes especificar folder/file.js.
La cantidad mínima de RAM requerida para alojar un bot es de 256MB y para un sitio/API es de 512MB. Sin embargo, dependiendo del tamaño y la complejidad de tu aplicación, puede ser recomendable asignar una mayor cantidad de RAM para evitar que tu aplicación se quede sin memoria y se bloquee.
Para otros problemas, consulta Solución de problemas.

​
Hacer deploy

​
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.
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.
Subiendo aplicación a Square Cloud
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 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.
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 squarecloud.ignore, y lo sube:
Para subir un zip que creaste tú mismo, pásalo con --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.
¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

​
Próximos pasos

Variables de entorno

Mantén secretos y ajustes fuera de tu código y léelos en tiempo de ejecución.

Dominio personalizado

Sirve tu app en tu propio dominio, desde el plan Standard.

Solución de problemas

Arregla una app que no inicia o un sitio que no responde.

​
Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.