Pular para o conteúdo principal
Um runtime na Square Cloud é o ambiente completo e isolado onde sua aplicação roda: o interpretador da linguagem ou máquina virtual, as bibliotecas de sistema às quais ela se vincula, o ferramental que ela pode invocar e a fronteira de segurança que a mantém separada de todas as outras aplicações no host. Você nunca constrói nem mantém esse ambiente. Você envia seu código-fonte e um pequeno arquivo de configuração; a Square Cloud detecta a linguagem, resolve suas dependências, provisiona um container isolado e o executa. O mesmo pipeline sustenta bots de Discord/WhatsApp/Telegram, sites e APIs, workers em segundo plano e serviços de longa duração, sobre a mesma infraestrutura rápida e blindada.

Linguagens suportadas

JavaScript

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

Além das linguagens acima, a maioria das outras stacks e bibliotecas funciona nativamente. As imagens de runtime são construídas para serem permissivas: se sua linguagem instala no Linux, é muito provável que ela rode na Square Cloud.

Versões

Cada runtime oferece dois canais de atualização, selecionáveis pelo campo VERSION no seu arquivo de configuração:
  • recommended — a versão que blindamos e executamos em produção para a maioria das aplicações. Escolha-a a menos que tenha um motivo específico para não fazê-lo.
  • latest — a release mais recente, para times que precisam de um recurso de linguagem recém-lançado.
Você também pode fixar uma versão exata para reprodutibilidade total entre deploys.
Linguagemrecommendedlatest
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
Fixar recommended garante atualizações de patch testadas automaticamente, sem quebras inesperadas. Consulte a referência do arquivo de configuração para os campos RUNTIME e VERSION.

Como um deploy funciona

Do upload até um processo no ar, todo deploy passa pelo mesmo pipeline determinístico:

Detecção de linguagem

A Square Cloud inspeciona os arquivos do seu upload e identifica a stack a partir dos sinais que já existem no seu projeto — um package.json para Node.js, um requirements.txt ou pyproject.toml para Python, um go.mod para Go, um Gemfile para Ruby, e assim por diante. Você pode sobrescrever a detecção explicitamente com o campo RUNTIME.

Resolução de dependências

Seu manifesto de dependências é instalado no servidor, dentro do ambiente de build. Você nunca envia node_modules, um virtualenv ou artefatos compilados dentro do .zip — a plataforma os resolve e instala para você, mantendo os uploads pequenos e os builds reproduzíveis.

Provisionamento

Um container isolado é criado com a CPU e a memória declaradas no seu arquivo de configuração. Os recursos são aplicados no nível do kernel, de modo que uma aplicação nunca consegue sufocar outra no mesmo host.

Inicialização

O campo MAIN aponta para seu arquivo de entrada e a plataforma o executa com o interpretador correto. Precisa de uma etapa de build, um servidor estático ou um comando personalizado? Defina START e ele é executado literalmente.

Dentro de cada imagem de runtime

Cada imagem é montada sobre uma base comum e auditada em segurança, garantindo que o ambiente seja consistente independentemente da linguagem que você faz deploy:

Node.js 26 + ferramental de build

Toda imagem embute o Node.js 26 ao lado da linguagem principal. Ferramentas de build em JS, pipelines de assets e utilitários estão sempre disponíveis, qualquer que seja sua stack.

ffmpeg e Chromium

Processamento de mídia (ffmpeg) e um navegador headless (Chromium) já vêm instalados — prontos para bots de mídia, web scraping e geração de PDF ou screenshots, sem configuração extra.

Sem privilégios por padrão

As aplicações rodam como um usuário não-root dentro de um container isolado. Uma dependência comprometida permanece contida — ela não tem acesso privilegiado ao host.

Sites estáticos, sem runtime

Não precisa de interpretador? Defina RUNTIME=static para servir um site em HTML/CSS/JS puro diretamente, com o mesmo CDN e TLS de qualquer outra aplicação.

Isolamento e segurança

Cada aplicação é um container totalmente isolado com limites de CPU e memória aplicados pelo kernel — nunca um processo compartilhado. Rodar sem privilégios significa que uma aplicação não consegue alcançar o host nem seus vizinhos, e os limites de recursos garantem que um pico em um projeto não tenha efeito algum sobre o desempenho de outro. É o mesmo modelo que permite à Square Cloud hospedar dezenas de milhares de cargas de trabalho em clusters compartilhados sem que interfiram entre si.

Próximos passos

Arquivo de configuração

Domine MAIN, START, RUNTIME, VERSION e MEMORY — os campos que controlam seu runtime.

Guias por linguagem

Configuração passo a passo para Node.js, Python, Go, Rust, Java e mais.