Vai al contenuto principale

​
Cos’è il file di configurazione?

Il file di configurazione è un file che contiene i parametri della tua applicazione, come il file principale, la memoria, la versione e altre impostazioni. Questo file viene usato per configurare ed effettuare il deploy della tua applicazione sulla piattaforma Square Cloud.
squarecloud.app
MAIN=main_file.js
DISPLAY_NAME=I am the configuration file
MEMORY=512
VERSION=recommended

​
Creare il file di configurazione

Creare il file di configurazione è molto semplice: basta creare un file chiamato squarecloud.app o squarecloud.config e aggiungere al suo interno i parametri di configurazione.
1

Scegli l'estensione

Il file di configurazione può avere due estensioni: .app o .config. Puoi usare squarecloud.app o squarecloud.config, quella che preferisci. Suggerimento: usa .app per aiutare a promuovere Square Cloud. 🥰😂
Su macOS, consigliamo di usare l’estensione .config.
Nota: .app o .config si riferisce all’estensione del file, non al nome del file.
2

Crea il file

Crea un file con l’estensione selezionata e aggiungi al suo interno i parametri di configurazione.

​
Parametri di configurazione

Di seguito puoi vedere tutti i parametri di configurazione disponibili per il tuo file di configurazione.
ParametroTipoModificabileLimiteUtilizzo
MAIN*String❌32 caratteriDefinisce il file principale dell’applicazione. Es.: index.js, main.py, ecc.
VERSION*String❌-Versione del linguaggio (Es.: recommended).
MEMORY*Integer✅-Quantità di memoria in megabyte.
DISPLAY_NAME*String✅32 caratteriNome visualizzato dell’applicazione.
RUNTIMEString❌-L’ambiente di runtime. Es.: typescript, nodejs, go.
DESCRIPTIONString✅280 caratteriDescrizione/metadati dell’applicazione.
AUTORESTARTBoolean✅-Riavvio automatico (true o false).
STARTString✅256 caratteriComando di avvio personalizzato.
SUBDOMAINString✅63 caratteriSottodominio del sito (se applicabile).
I parametri modificabili (✅) possono essere modificati nella dashboard dopo il deploy. I parametri non modificabili (❌) richiedono un ricaricamento completo dell’applicazione per applicare le modifiche.

​
Dettaglio dei parametri di configurazione

Di seguito puoi vedere i parametri di configurazione che puoi usare nel tuo file di configurazione.

MAIN [*]

Tipo: String | Modificabile: ❌ | Limite: 32 caratteriDefinisce il file principale dell’applicazione.
MAIN=index.js

MAIN=src/loaders/index.js
Quando questo parametro è impostato, l’ambiente di runtime verrà dedotto in base all’estensione del file principale
Questa impostazione viene IGNORATA se usi il parametro START.

MEMORY [*]

Tipo: Integer | Modificabile: ✅ | Limite: Minimo 256MB (bot), 512MB (sito)Definisce la quantità di memoria che la tua applicazione utilizzerà.
MEMORY=256
Il valore deve essere specificato in megabyte (MB).

VERSION [*]

Tipo: String | Modificabile: ❌ | Valori: recommended, latest o versione specifica
Consigliamo di usare recommended per una stabilità ottimale.
Definisce la versione del linguaggio per la tua applicazione.
VERSION=recommended
Linguaggiorecommendedlatest
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 | Modificabile: ✅ | Limite: 32 caratteriDefinisce il nome visualizzato della tua applicazione.
DISPLAY_NAME=Admin BOT

DESCRIPTION

Tipo: String | Modificabile: ✅ | Limite: 280 caratteriDefinisce la descrizione della tua applicazione.
DESCRIPTION=This bot is designed to help you with your daily tasks.

AUTORESTART

Tipo: Boolean | Modificabile: ✅ | Valori: true, false | Predefinito: falseDefinisce se l’applicazione debba riavviarsi automaticamente in caso di errore.
AUTORESTART=true

SUBDOMAIN

Tipo: String | Modificabile: ✅ | Limite: 63 caratteri | Predefinito: undefinedDefinisce il sottodominio per il tuo sito (solo applicazioni web).
SUBDOMAIN=mysite
L’URL finale sarà: mysite.squareweb.app

RUNTIME

Tipo: String | Modificabile: ❌Definisce manualmente un ambiente di runtime.
RUNTIME=nodejs
Consulta di seguito i valori e gli ambienti accettati.
AmbienteRUNTIME
Nodejsnodejs, javascript
TypeScripttypescript
Pythonpython
C#/Dotnetc#, dotnet, csharp
Elixirelixir
Javajava
Rustrust
Rubyruby, rb
PHPphp
Golanggo, golang
HTML/CSSstatic, html
Se imposti questo parametro, non è necessario impostare MAIN; imposta invece un comando START personalizzato.

START

Tipo: String | Modificabile: ✅ | Limite: 256 caratteri | Predefinito: undefinedDefinisce un comando di avvio personalizzato.
START=npm run start
Questo parametro sovrascrive il comportamento predefinito di MAIN.

​
Esempi di configurazione per i bot

Ecco alcuni esempi di configurazione per i bot: 
# 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

​
Esempi di configurazione per i siti

Ecco alcuni esempi di configurazione per i siti web:
L’URL del sito sarà: 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 come MAIN viene usato solo per far riconoscere al sistema il progetto come progetto JavaScript o TypeScript (un altro file .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