> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Runtimes

> Rode praticamente qualquer stack na Square Cloud. Linguagens suportadas, versões e como a plataforma detecta e executa sua aplicação.

A Square Cloud roda praticamente qualquer stack — bots de Discord, WhatsApp e Telegram, sites e APIs, workers em segundo plano e aplicações completas — na mesma infraestrutura rápida e segura. Você traz o código e um pequeno arquivo de configuração; a plataforma detecta a linguagem, instala as dependências e executa.

## Linguagens suportadas

<CardGroup cols={3}>
  <Card title="JavaScript" icon="node-js" href="../articles/getting-started-with-nodejs" />

  <Card title="Python" icon="python" href="../articles/getting-started-with-python" />

  <Card title="Java" icon="java" href="../articles/getting-started-with-java" />

  <Card title="Rust" icon="rust" href="../articles/getting-started-with-rust" />

  <Card title="Elixir" icon="droplet" href="../articles/getting-started-with-elixir" />

  <Card title="PHP" icon="php" href="../articles/getting-started-with-php" />

  <Card title="Go" icon="golang" href="../articles/getting-started-with-go" />

  <Card title="C#" icon="c" href="../articles/getting-started-with-csharp" />

  <Card title="Ruby" icon="gem" href="../articles/getting-started-with-ruby" />
</CardGroup>

<Info>
  Além dessas, muitas outras linguagens e bibliotecas funcionam de imediato. As imagens de runtime são flexíveis o suficiente para se adaptar à maioria dos projetos.
</Info>

## Versões

Cada runtime oferece dois canais que você fixa com o campo `VERSION` no arquivo de configuração: `recommended` (estabilidade) e `latest` (mais recente). Você também pode fixar uma versão exata.

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

<Tip>Prefira `recommended`, a menos que você precise especificamente de uma versão mais nova. Veja o [arquivo de configuração](/pt-br/getting-started/config-file) para os campos `VERSION` e `RUNTIME`.</Tip>

## Como funciona

<Steps>
  <Step title="Detecção da linguagem">
    A Square Cloud detecta sua linguagem automaticamente a partir dos arquivos do seu upload (por exemplo, um `package.json` para Node.js ou um `requirements.txt` para Python). Você pode sobrescrever a detecção com o campo `RUNTIME` no arquivo de configuração.
  </Step>

  <Step title="Instalação de dependências">
    Seu arquivo de dependências (`package.json`, `requirements.txt`, `Gemfile`, `go.mod`, ...) é instalado no servidor, então você não precisa enviar `node_modules` ou um ambiente virtual dentro do `.zip`.
  </Step>

  <Step title="Comando de início">
    O campo `MAIN` aponta para o arquivo de entrada e a plataforma o executa com o interpretador correto. Para um comando de início personalizado (etapas de build, um servidor estático, etc.) defina o `START`.
  </Step>
</Steps>

## O que já vem em todo runtime

<CardGroup cols={2}>
  <Card title="Node.js 26 + ferramentas" icon="node-js">
    Toda imagem traz o Node.js 26 junto da linguagem principal, então ferramentas de build e utilitários em JS estão sempre disponíveis.
  </Card>

  <Card title="ffmpeg e Chromium" icon="film">
    Processamento de mídia (ffmpeg) e um navegador headless (Chromium) já vêm instalados — úteis para bots de mídia, scraping e geração de PDF/screenshots.
  </Card>

  <Card title="Roda como não-root" icon="shield-halved">
    As aplicações rodam como um usuário sem privilégios, para um ambiente mais seguro e isolado.
  </Card>

  <Card title="Sites estáticos" icon="file-code">
    Não precisa de runtime? Defina `RUNTIME=static` (ou `html`) para servir um site HTML/CSS/JS puro diretamente.
  </Card>
</CardGroup>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Arquivo de configuração" icon="gear" href="/pt-br/getting-started/config-file">
    Conheça os campos `MAIN`, `START`, `RUNTIME` e `VERSION`.
  </Card>

  <Card title="Tutoriais práticos" icon="graduation-cap" href="/pt-br/tutorials/how-to-deploy-your-website">
    Faça deploy de projetos reais, passo a passo, na sua linguagem preferida.
  </Card>
</CardGroup>