How to create your squarecloud.app configuration file

What is the configuration file?

The configuration file is a file that contains your application’s parameters, such as the main file, memory, version and other settings. This file is used to configure and deploy your application on the Square Cloud platform.

squarecloud.app

MAIN=main_file.js
DISPLAY_NAME=I am the configuration file
MEMORY=512
VERSION=recommended

Creating the configuration file

Creating the configuration file is very simple: just create a file named squarecloud.app or squarecloud.config and add the configuration parameters inside it.

Choose extension

The configuration file can have two extensions: .app or .config. You can use squarecloud.app or squarecloud.config, whichever you prefer. Tip: use .app to help promote Square Cloud. 🥰😂

On macOS, we recommend using the .config extension.

Note: .app or .config refers to the file extension, not the file name.

Create file

Create a file with the selected extension and add the configuration parameters inside it.

Configuration parameters

Below you can see all the configuration parameters available for your configuration file.

Parameter	Type	Editable	Limit	Usage
`MAIN*`	String	❌	32 chars	Defines the main application file. Ex.: `index.js`, `main.py`, etc.
`VERSION*`	String	❌	-	Language version (Ex.: `recommended`).
`MEMORY*`	Integer	✅	-	Amount of memory in megabytes.
`DISPLAY_NAME*`	String	✅	32 chars	Display name of the application.
`RUNTIME`	String	❌	-	The runtime environment. Ex.: `typescript`, `nodejs`, `go`.
`DESCRIPTION`	String	✅	280 chars	Description/metadata of the application.
`AUTORESTART`	Boolean	✅	-	Auto-restart (`true` or `false`).
`START`	String	✅	256 chars	Custom start command.
`SUBDOMAIN`	String	✅	63 chars	Website subdomain (if applicable).

Editable parameters (✅) can be modified in the dashboard after deployment. Non-editable (❌) parameters require a full reupload of the application to make changes.

Detailing the configuration parameters

Below you can see the configuration parameters you can use in your configuration file.

MAIN [*]

Type: String | Editable: ❌ | Limit: 32 charsDefines the main application file.

MAIN=index.js

MAIN=src/loaders/index.js

When this parameter is set, the runtime environment will be inferred based on the main file extension

This setting is IGNORED if you use the START parameter.

MEMORY [*]

Type: Integer | Editable: ✅ | Limit: Minimum 256MB (bot), 512MB (site)Defines the amount of memory your application will use.

MEMORY=256

The value must be specified in megabytes (MB).

VERSION [*]

Type: String | Editable: ❌ | Values: recommended, latest or specific version

We recommend using recommended for optimal stability.

Defines the language version for your application.

VERSION=recommended

Language	`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 [*]

Type: String | Editable: ✅ | Limit: 32 charsDefines the display name of your application.

DISPLAY_NAME=Admin BOT

DESCRIPTION

Type: String | Editable: ✅ | Limit: 280 charsDefines the description of your application.

DESCRIPTION=This bot is designed to help you with your daily tasks.

AUTORESTART

Type: Boolean | Editable: ✅ | Values: true, false | Default: falseDefines whether the application should automatically restart on failure.

AUTORESTART=true

SUBDOMAIN

Type: String | Editable: ✅ | Limit: 63 chars | Default: undefinedDefines the subdomain for your site (web applications only).

SUBDOMAIN=mysite

The final URL will be: mysite.squareweb.app

RUNTIME

Type: String | Editable: ❌Defines a runtime environment manually.

RUNTIME=nodejs

Check the accepted values and environments below.

Environment	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`

If you set this parameter, you don’t need to set MAIN; instead, set a custom START command.

START

Type: String | Editable: ✅ | Limit: 256 chars | Default: undefinedDefines a custom start command.

START=npm run start

This parameter overrides the default MAIN behavior.

Configuration examples for bots

Here are some examples of configuration for 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

Configuration examples for sites

Here are some examples of configuration for websites:

The site URL will be: 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 as MAIN is only used to let the system recognize the project as a JavaScript or TypeScript project (another .ts/.tsx file)

# 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

Services

Runtimes

Platform

Troubleshooting

CLI

SDKs

Changelog

How to create your squarecloud.app configuration file

What is the configuration file?

Creating the configuration file

Configuration parameters

Detailing the configuration parameters

Configuration examples for bots

Configuration examples for sites

​What is the configuration file?

​Creating the configuration file

​Configuration parameters

​Detailing the configuration parameters

​Configuration examples for bots

​Configuration examples for sites

What is the configuration file?

Creating the configuration file

Configuration parameters

Detailing the configuration parameters

Configuration examples for bots

Configuration examples for sites