​
O que é o arquivo de configuração?

O arquivo de configuração é um arquivo que contém os parâmetros da sua aplicação, como o arquivo principal, memória, versão e outros parâmetros. Esse arquivo é usado para configurar e implantar sua aplicação na plataforma Square Cloud.
squarecloud.app
MAIN=arquivo_principal.js
DISPLAY_NAME=Eu sou o tal arquivo de configuração
MEMORY=512
VERSION=recommended

​
Criando o arquivo de configuração

É muito simples criar o arquivo de configuração: basta criar um arquivo com o nome squarecloud.app ou squarecloud.config e colocar os parâmetros de configuração dentro dele.
1

Selecionar extensão

O arquivo de configuração pode ter duas extensões: .app ou .config. Na prática, pode ser: squarecloud.app ou squarecloud.config e você pode escolher o que preferir. Dica: use .app para ajudar a promover a Square Cloud. 🥰😂
No macOS, recomendamos usar a extensão .config.
Observação: .app ou .config é a extensão do arquivo, não o nome.
2

Criar arquivo

Crie um arquivo com a extensão selecionada e coloque os parâmetros de configuração dentro dele.

​
Parâmetros de configuração

Abaixo você pode ver todos os parâmetros de configuração disponíveis para seu arquivo de configuração.
ParâmetroTipoEditávelLimiteUso
MAIN*String❌32 caracteres.Define o arquivo principal da aplicação. Ex.: index.js, main.py, etc.
VERSION*String❌-Versão da linguagem (Ex.: recommended).
MEMORY*Integer✅-Quantidade de memória em megabytes.
DISPLAY_NAME*String✅32 caracteres.Nome de exibição da aplicação.
DESCRIPTIONString✅280 caracteres.Descrição/metadados da aplicação.
AUTORESTARTBoolean✅-Reinício automático (true ou false).
STARTString✅256 caracteres.Comando personalizado de inicialização.
SUBDOMAINString✅63 caracteres.Subdomínio do website. (caso aplicável)
Parâmetros editáveis (✅) podem ser modificados no painel após deploy. Não editáveis (❌) requerem reenvio completo da aplicação para alterações.

​
Detalhando os parâmetros de configuração

Abaixo você pode ver os parâmetros de configuração que pode usar no seu arquivo de configuração.

MAIN [*]

Tipo: String | Editável: ❌ | Limite: 32 caracteres.Define o arquivo principal da sua aplicação.
Exemplo:
MAIN=index.js
Também suporta diretórios:
MAIN=src/loaders/index.js
Esta configuração é IGNORADA se você usar o parâmetro START.

MEMORY [*]

Tipo: Integer | Editável: ✅ | Limite: Mínimo 256MB (bot), 512MB (site).Define a quantidade de memória que sua aplicação usará.
MEMORY=256
O valor deve ser especificado em megabytes (MB).

VERSION [*]

Tipo: String | Editável: ❌ | Valores: recommended, latest ou versão específica.
Recomendamos usar recommended para melhor estabilidade.
Define a versão da linguagem da sua aplicação.
VERSION=recommended
Linguagemrecommendedlatest
JavaScript [Node.js]22.18.024.5.0
Python3.13.63.13.6
JavaJDK 23JDK 25
Elixir1.18.41.18.4
Rust1.89.01.89.0
PHP8.4.118.4.11
Go1.24.61.24.6
C#9.0.19.0.1

DISPLAY_NAME [*]

Tipo: String | Editável: ✅ | Limite: 32 caracteres.Define o nome de exibição da sua aplicação.
DISPLAY_NAME=Admin BOT

DESCRIPTION

Tipo: String | Editável: ✅ | Limite: 280 caracteres.Define a descrição da sua aplicação.
DESCRIPTION=This bot is designed to help you with your daily tasks.

AUTORESTART

Tipo: Boolean | Editável: ✅ | Valores: true, false | Padrão: falseDefine se a aplicação deve reiniciar automaticamente em caso de falha.
AUTORESTART=true

SUBDOMAIN

Tipo: String | Editável: ✅ | Limite: 63 caracteres. | Padrão: não definido.Define o subdomínio do seu site (apenas para aplicações web).
SUBDOMAIN=mysite
O URL final será: mysite.squareweb.app

START

Tipo: String | Editável: ✅ | Limite: 256 caracteres. | Padrão: não definido.Define um comando personalizado de inicialização.
START=npm run start
Este parâmetro substitui o comportamento padrão do MAIN.

​
Exemplos de configuração para bots

Temos alguns exemplos de configurações para bots; abaixo você pode ver alguns exemplos.
Parâmetros obrigatórios.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot
Exemplo com todos os parâmetros.
MAIN=index.js
MEMORY=512
VERSION=recommended
DISPLAY_NAME=Robin bot
DESCRIPTION=Este bot foi criado para ajudar em suas tarefas diárias.
START=npm run start
AUTORESTART=true

​
Exemplos de configuração para sites

Temos alguns exemplos de configurações para sites; abaixo você pode ver alguns exemplos.
O URL do site será: mysite.squareweb.app
Exemplo com todos os parâmetros.
MAIN=index.js
MEMORY=1024
VERSION=recommended
DISPLAY_NAME=Meu site
DESCRIPTION=Meu site é muito legal!
SUBDOMAIN=mysite
START=npm run build && npm run start
AUTORESTART=true
MAIN next.config.js usado apenas para o sistema reconhecer o projeto como um projeto JavaScript ou TypeScript (outro arquivo .ts/.tsx)
Exemplo de site Next.js.
MAIN=next.config.js
MEMORY=2048
VERSION=recommended
DISPLAY_NAME=Site Next.js
DESCRIPTION=Este site foi construído com Next.js.
SUBDOMAIN=nextjs
START=npm run build && npm run start
AUTORESTART=true