Saltar al contenido principal

​
¿Qué es el archivo de configuración?

El archivo de configuración es un archivo que contiene los parámetros de tu aplicación, como el archivo principal, la memoria, la versión y otros ajustes. Este archivo se usa para configurar y desplegar tu aplicación en la plataforma de Square Cloud.
squarecloud.app
MAIN=main_file.js
DISPLAY_NAME=I am the configuration file
MEMORY=512
VERSION=recommended

​
Creando el archivo de configuración

Crear el archivo de configuración es muy sencillo: solo crea un archivo llamado squarecloud.app o squarecloud.config y añade los parámetros de configuración dentro de él.
1

Elige la extensión

El archivo de configuración puede tener dos extensiones: .app o .config. Puedes usar squarecloud.app o squarecloud.config, la que prefieras. Consejo: usa .app para ayudar a promocionar Square Cloud. 🥰😂
En macOS, recomendamos usar la extensión .config.
Nota: .app o .config se refiere a la extensión del archivo, no al nombre del archivo.
2

Crea el archivo

Crea un archivo con la extensión seleccionada y añade los parámetros de configuración dentro de él.

​
Parámetros de configuración

A continuación puedes ver todos los parámetros de configuración disponibles para tu archivo de configuración.
ParámetroTipoEditableLímiteUso
MAIN*String❌32 caracteresDefine el archivo principal de la aplicación. Ej.: index.js, main.py, etc.
VERSION*String❌-Versión del lenguaje (Ej.: recommended).
MEMORY*Integer✅-Cantidad de memoria en megabytes.
DISPLAY_NAME*String✅32 caracteresNombre visible de la aplicación.
RUNTIMEString❌-El entorno de ejecución. Ej.: typescript, nodejs, go.
DESCRIPTIONString✅280 caracteresDescripción/metadatos de la aplicación.
AUTORESTARTBoolean✅-Reinicio automático (true o false).
STARTString✅256 caracteresComando de inicio personalizado.
SUBDOMAINString✅63 caracteresSubdominio del sitio web (si aplica).
Los parámetros editables (✅) pueden modificarse en el panel de control después del despliegue. Los parámetros no editables (❌) requieren volver a subir por completo la aplicación para aplicar los cambios.

​
Detallando los parámetros de configuración

A continuación puedes ver los parámetros de configuración que puedes usar en tu archivo de configuración.

MAIN [*]

Tipo: String | Editable: ❌ | Límite: 32 caracteresDefine el archivo principal de la aplicación.
MAIN=index.js

MAIN=src/loaders/index.js
Cuando se establece este parámetro, el entorno de ejecución se inferirá según la extensión del archivo principal
Este ajuste se IGNORA si usas el parámetro START.

MEMORY [*]

Tipo: Integer | Editable: ✅ | Límite: Mínimo 256MB (bot), 512MB (sitio)Define la cantidad de memoria que usará tu aplicación.
MEMORY=256
El valor debe especificarse en megabytes (MB).

VERSION [*]

Tipo: String | Editable: ❌ | Valores: recommended, latest o una versión específica
Recomendamos usar recommended para una estabilidad óptima.
Define la versión del lenguaje para tu aplicación.
VERSION=recommended
Lenguajerecommendedlatest
Node.js [JS & TS]24.15.026.1.0
Python3.13.133.14.5
JavaJDK 25JDK 25
Elixir1.19.51.19.5
Rust1.95.01.95.0
Ruby4.0.44.0.4
PHP8.5.68.5.6
Go1.26.31.26.3
.NET/C#10.0.810.0.8

DISPLAY_NAME [*]

Tipo: String | Editable: ✅ | Límite: 32 caracteresDefine el nombre visible de tu aplicación.
DISPLAY_NAME=Admin BOT

DESCRIPTION

Tipo: String | Editable: ✅ | Límite: 280 caracteresDefine la descripción de tu aplicación.
DESCRIPTION=This bot is designed to help you with your daily tasks.

AUTORESTART

Tipo: Boolean | Editable: ✅ | Valores: true, false | Predeterminado: falseDefine si la aplicación debe reiniciarse automáticamente en caso de fallo.
AUTORESTART=true

SUBDOMAIN

Tipo: String | Editable: ✅ | Límite: 63 caracteres | Predeterminado: undefinedDefine el subdominio de tu sitio (solo aplicaciones web).
SUBDOMAIN=mysite
La URL final será: mysite.squareweb.app

RUNTIME

Tipo: String | Editable: ❌Define un entorno de ejecución manualmente.
RUNTIME=nodejs
Consulta los valores y entornos aceptados a continuación.
EntornoRUNTIME
Nodejsnodejs, javascript
TypeScripttypescript
Pythonpython
C#/Dotnetc#, dotnet, csharp
Elixirelixir
Javajava
Rustrust
Rubyruby, rb
PHPphp
Golanggo, golang
HTML/CSSstatic, html
Si estableces este parámetro, no necesitas establecer MAIN; en su lugar, define un comando START personalizado.

START

Tipo: String | Editable: ✅ | Límite: 256 caracteres | Predeterminado: undefinedDefine un comando de inicio personalizado.
START=npm run start
Este parámetro anula el comportamiento predeterminado de MAIN.

​
Ejemplos de configuración para bots

Aquí tienes algunos ejemplos de configuración para bots: 
# Required parameters.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot

# Example with all parameters.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot
DESCRIPTION=This bot was created to help with your daily tasks.
START=npm run start
AUTORESTART=true

​
Ejemplos de configuración para sitios

Aquí tienes algunos ejemplos de configuración para sitios web:
La URL del sitio será: mysite.squareweb.app
# Example with all parameters.
MAIN=index.js
MEMORY=1024
VERSION=recommended
DISPLAY_NAME=My site
DESCRIPTION=My site is really cool!
SUBDOMAIN=mysite
START=npm run build && npm run start
AUTORESTART=true
next.config.js como MAIN solo se usa para que el sistema reconozca el proyecto como un proyecto de JavaScript o TypeScript (otro archivo .ts/.tsx)
# Example for a Next.js site.
MAIN=next.config.js
MEMORY=2048
VERSION=recommended
DISPLAY_NAME=Next.js site
DESCRIPTION=This site was built with Next.js.
SUBDOMAIN=nextjs
START=npm run build && npm run start
AUTORESTART=true