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

# Hospedagem de Bots e APIs

> Como a SonderCloud hospeda seus apps, do upload ao container em produção

## Dois tipos de app

Todo app na SonderCloud é de um dos dois tipos abaixo. O tipo é decidido automaticamente: **se você informar um domínio (`domain`), o app é tratado como aplicação web**; caso contrário, ele roda como um processo isolado sem porta exposta — perfeito para bots.

> **App Web / API**
>
> Recebe domínio próprio (`seu-app.sondercloud.app`), fica acessível via HTTP/HTTPS e é ideal para APIs REST, painéis, webhooks e qualquer coisa que precise responder requisições externas.

> **Bot / Worker**
>
> Sem domínio, sem porta exposta. Roda continuamente em segundo plano — o caso clássico de bots de Discord, Telegram, WhatsApp, workers de fila, cron jobs de longa duração, etc.

***

## Linguagens com builder dedicado

**Node.js**

Runtime padrão da plataforma. Se `LANGUAGE` não for informado ou não bater com nenhuma das linguagens abaixo, o build cai automaticamente para Node.js.

**Python**

`LANGUAGE=python`. Suporta `requirements.txt` para instalação de dependências.

**Ruby**

`LANGUAGE=ruby`.

**Java**

`LANGUAGE=java`.

**PHP**

`LANGUAGE=php`.

**Go**

`LANGUAGE=go`.

**Rust**

`LANGUAGE=rust`.

**Estático**

`LANGUAGE=static`. Para sites puramente HTML/CSS/JS, sem servidor de aplicação.

> [!TIP]
>
> Veja a configuração completa via arquivo declarativo em [sonder.config](https://docs.sondercloud.app/inicio/sonder-config.md).

***

## O ciclo de vida de um app

Cada mudança de estado fica disponível em tempo real via [`GET /v1/apps/{id}`](https://docs.sondercloud.app/api-reference/endpoint/apps/get) e nos logs (`GET /v1/apps/{id}/logs`).

***

## Ferramentas de gerenciamento

> **Ciclo de vida completo**
>
> Inicie, pare, reinicie, reconstrua ou delete seu app a qualquer momento:
>
> * [`POST /v1/apps/{id}/start`](https://docs.sondercloud.app/api-reference/endpoint/apps/start)
> * [`POST /v1/apps/{id}/stop`](https://docs.sondercloud.app/api-reference/endpoint/apps/stop)
> * [`POST /v1/apps/{id}/restart`](https://docs.sondercloud.app/api-reference/endpoint/apps/restart)
> * [`POST /v1/apps/{id}/rebuild`](https://docs.sondercloud.app/api-reference/endpoint/apps/rebuild) — assíncrono, reconstrói a partir do último código enviado
> * [`POST /v1/apps/{id}/commit`](https://docs.sondercloud.app/api-reference/endpoint/apps/commit) — síncrono, envia código novo e já aguarda o resultado

> **Editor de arquivos via API**
>
> Sem precisar reenviar o `.zip` inteiro, edite arquivos individuais direto no container:
>
> * Listar (`files`), ler, escrever, renomear/mover, criar pastas e deletar — tudo documentado na seção [Apps · Arquivos](https://docs.sondercloud.app/api-reference/endpoint/apps/files-list.md).

> **Backup sob demanda**
>
> [`POST /v1/apps/{id}/backup`](https://docs.sondercloud.app/api-reference/endpoint/apps/backup) gera um `.zip` com o código-fonte atual do app para download imediato. Não fica armazenado no servidor — pense nele como um "exportar agora".

> **Monitoramento em tempo real**
>
> [`GET /v1/apps/{id}/stats`](https://docs.sondercloud.app/api-reference/endpoint/apps/stats) retorna CPU, RAM, tráfego de rede e número de processos ativos no container, atualizados a cada consulta.

***

## Proteção automática

A SonderCloud roda uma verificação de saúde periódica em todos os apps ativos, cuidando de três frentes:

> **Memória (OOM)**
>
> Detecta quando um container é finalizado por estourar o limite de memória e notifica o dono do app.

> **Tráfego de rede**
>
> Monitora picos anormais de entrada/saída para proteger a rede compartilhada de abuso.

> **Processos**
>
> Acompanha o número de processos ativos dentro do container para identificar comportamento fora do padrão.

***

## Databases

Além de apps, você também pode hospedar bancos de dados na SonderCloud: **PostgreSQL**, **MySQL**, **MongoDB** e **Redis**. Cada database roda isolada, com usuário e senha próprios, e pode ser conectada tanto de fora da plataforma quanto direto de outro app seu — sem sair da rede interna. Veja como criar e gerenciar em [Databases](https://docs.sondercloud.app/api-reference/endpoint/databases/create.md).

***

## Pronto para começar?

> **[Criar seu primeiro app](https://docs.sondercloud.app/api-reference/endpoint/apps/upload.md)**
>
> Veja como fazer upload e configurar seu app.

> **[sonder.config](https://docs.sondercloud.app/inicio/sonder-config.md)**
>
> Configure tudo declarativamente, direto no .zip.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.