npx deno.
Antes de empezar
- Deno en tu máquina, desde el instalador oficial de Deno, o el paquete de npm (
npm install deno). - 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
squarecloud.app por ti.Referencia del archivo de configuración
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.deno a las dependencies de tu proyecto, para que el comando npx deno esté disponible en Square Cloud. No lo añadas a devDependencies: no se instalan en producción.
RUNTIME=nodejs e inicia tu app con Deno en el campo START, con los permisos que necesite. Un archivo de configuración completo para cada tipo de app:
- Bot o worker
- Sitio web o API
--allow-net, --allow-env, --allow-read y otros) a lo que use tu app. Si usas tareas definidas en deno.json, inicia con START=npx deno task start.
Qué ejecuta Square Cloud
STARTse ejecuta 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 ejecutanpm install --no-audit --no-fundantes de iniciarla, lo que también instaladenoy cualquier módulo de npm listado enpackage.json. Los paquetes dedevDependenciesno se instalan, porque el runtime defineNODE_ENV=production. Cuandonode_modulesya existe, se omite el paso de instalación.
Puerto y host para sitios web y APIs
Deno.serve() escucha en el puerto 8000 por defecto y no lee la variable de entorno PORT. Pasa tú el puerto y el host: Square Cloud define PORT como 80, y 0.0.0.0 acepta conexiones desde fuera del contenedor.
PORT requiere --allow-env, y servir requiere --allow-net, como en los ejemplos de START de arriba.
Preparar el proyecto
Archivos necesarios
squarecloud.app, en la raíz del ZIP.- Tu archivo de entrada, por ejemplo
main.ts. package.json, condenoendependencies. Una subida sin él falla conINVALID_DEPENDENCY.- Opcionalmente, un
deno.jsonodeno.jsoncpara tareas, imports y otros ajustes de Deno.
Qué dejar fuera
node_modules: Square Cloud elimina esta carpeta de tu subida e instala las dependencias desdepackage.jsonen el primer inicio.deno_diro.cache/deno: el directorio de caché de Deno, que Deno vuelve a llenar en el servidor.- Archivos de bloqueo: la CLI y la extensión de VS Code dejan fuera
package-lock.json,yarn.lockypnpm-lock.yamlpor defecto. Cuando necesites las versiones exactas de tupackage-lock.json, vuelve a incluirlo con!package-lock.jsonen tusquarecloud.ignore.
Solución de problemas
PermissionDenied: Requires net or env access
PermissionDenied: Requires net or env access
START el flag que indica el error, como --allow-net o --allow-env.Memoria insuficiente
Memoria insuficiente
Hacer deploy
A través del panel
Accede a la página de subida
Configura tu entorno
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
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

Confirma que tu aplicación esté en vivo
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
squarecloud.app que define el entorno de tu aplicación.Instala la CLI
Inicia sesión
Sube tu proyecto
squarecloud.ignore, y lo sube:--file:Confirma que tu aplicación esté en vivo
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.

