Come creare il tuo file di configurazione squarecloud.app

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.

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.

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.

Parametro	Tipo	Modificabile	Limite	Utilizzo
`MAIN*`	String	❌	32 caratteri	Definisce 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 caratteri	Nome visualizzato dell’applicazione.
`RUNTIME`	String	❌	-	L’ambiente di runtime. Es.: `typescript`, `nodejs`, `go`.
`DESCRIPTION`	String	✅	280 caratteri	Descrizione/metadati dell’applicazione.
`AUTORESTART`	Boolean	✅	-	Riavvio automatico (`true` o `false`).
`START`	String	✅	256 caratteri	Comando di avvio personalizzato.
`SUBDOMAIN`	String	✅	63 caratteri	Sottodominio 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

Linguaggio	`recommended`	`latest`
Node.js [JS & TS]	24.15.0	26.1.0
Python	3.13.13	3.14.5
Java	JDK 25	JDK 25
Elixir	1.19.5	1.19.5
Rust	1.95.0	1.95.0
Ruby	4.0.4	4.0.4
PHP	8.5.6	8.5.6
Go	1.26.3	1.26.3
.NET/C#	10.0.8	10.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.

Ambiente	RUNTIME
Nodejs	`nodejs`, `javascript`
TypeScript	`typescript`
Python	`python`
C#/Dotnet	`c#`, `dotnet`, `csharp`
Elixir	`elixir`
Java	`java`
Rust	`rust`
Ruby	`ruby`, `rb`
PHP	`php`
Golang	`go`, `golang`
HTML/CSS	`static`, `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

Servizi

Runtimes

Piattaforma

Risoluzione dei problemi

CLI

SDKs

Changelog

Come creare il tuo file di configurazione squarecloud.app

Cos’è il file di configurazione?

Creare il file di configurazione

Parametri di configurazione

Dettaglio dei parametri di configurazione

Esempi di configurazione per i bot

Esempi di configurazione per i siti

​Cos’è il file di configurazione?

​Creare il file di configurazione

​Parametri di configurazione

​Dettaglio dei parametri di configurazione

​Esempi di configurazione per i bot

​Esempi di configurazione per i siti

Cos’è il file di configurazione?

Creare il file di configurazione

Parametri di configurazione

Dettaglio dei parametri di configurazione

Esempi di configurazione per i bot

Esempi di configurazione per i siti