> ## 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.

# Hospedagem de sites e APIs com SSL e CDN

> Coloque seu site ou API no ar com SSL automático, CDN global e WAF da Cloudflare. Subdomínio squareweb.app incluso e domínio próprio a partir do Standard.

<Frame>
  <img src="https://squarecloud.app/banners/pt-br/sites.png" alt="Visão geral do serviço Sites da Square Cloud" style={{ borderRadius: "0.2rem" }} />
</Frame>

## Por que escolher a Square Cloud?

Todo site é servido por trás da rede global da Cloudflare, com TLS gratuito, CDN gratuita e proteção contra DDoS ativos por padrão: o mesmo edge de nível de produção, seja para uma landing page estática ou para uma aplicação SSR completa com framework. Você configura um subdomínio, e nós cuidamos dos certificados, do cache e do roteamento.

<CardGroup cols={2}>
  <Card title="Edge Cloudflare + Square Shield" icon="shield-check">
    Todo site fica atrás do **WAF da Cloudflare** com o **Square Shield** por cima: mitigação de DDoS, filtragem de bots e TLS gratuito com renovação automática, inclusos sem custo adicional.
  </Card>

  <Card title="NVMe + 10Gbps, isolado" icon="bolt">
    **SSDs NVMe empresariais** e uplinks de **10Gbps**, com sua aplicação em um container isolado. Somados a uma **CDN global gratuita**, os assets estáticos ficam em cache no edge e são servidos perto de cada visitante.
  </Card>

  <Card title="DNS gerenciado" icon="globe">
    **Traga seu próprio domínio, o certificado fica por nossa conta**: [conecte um domínio que você já tem](https://help.squarecloud.app/pt-br/article/como-configurar-seu-proprio-dominio-cnamedns-j39hh2/) (Standard ou superior), crie no seu provedor de DNS os registros que o dashboard mostra, e a Square Cloud emite e renova o certificado TLS assim que eles propagarem.
  </Card>

  <Card title="Snapshots instantâneos" icon="server">
    **Pontos de restauração em um clique**, inclusos sem custo adicional. Recupere-se de um deploy quebrado em segundos, sem perda de dados e com **zero downtime**.
  </Card>
</CardGroup>

## Ambientes suportados

Hospede seu site com a stack que você já usa. Comece pelo [guia de hospedagem de sites e APIs](/pt-br/tutorials/how-to-deploy-your-website) e depois escolha o seu framework abaixo: cada cartão abre um guia passo a passo com código.

### Frameworks

<CardGroup cols={3}>
  <Card title="Angular" icon="angular" href="/pt-br/tutorials/website/angular" />

  <Card title="Astro" icon="rocket-vertical" href="/pt-br/tutorials/website/astrojs" />

  <Card title="Gatsby" icon="g" href="/pt-br/tutorials/website/gatsby" />

  <Card title="Next.js" icon="n" href="/pt-br/tutorials/website/nextjs" />

  <Card title="Nuxt" icon="mountains" href="/pt-br/tutorials/website/nuxt" />

  <Card title="Phoenix" icon="phoenix-framework" href="/pt-br/tutorials/website/phoenix" />

  <Card title="Preact" icon="atom-simple" href="/pt-br/tutorials/website/preact" />

  <Card title="Qwik" icon="circle-bolt" href="/pt-br/tutorials/website/qwik" />

  <Card title="React" icon="react" href="/pt-br/tutorials/website/react" />

  <Card title="React Router (Remix)" icon="bolt" href="/pt-br/tutorials/website/remix" />

  <Card title="Ruby on Rails" icon="gem" href="/pt-br/tutorials/website/ruby-on-rails" />

  <Card title="SolidJS" icon="s" href="/pt-br/tutorials/website/solidjs" />

  <Card title="Vite" icon="v" href="/pt-br/tutorials/website/vite" />

  <Card title="Vue" icon="vuejs" href="/pt-br/tutorials/website/vue" />

  <Card title="HTML/CSS estático" icon="html5" href="/pt-br/articles/getting-started-with-html" />
</CardGroup>

### APIs e backends

<CardGroup cols={4}>
  <Card title="Django" icon="python" href="/pt-br/tutorials/api/django" />

  <Card title="Express" icon="network-wired" href="/pt-br/tutorials/api/express" />

  <Card title="FastAPI" icon="bolt" href="/pt-br/tutorials/api/fastapi" />

  <Card title="Fastify" icon="cat" href="/pt-br/tutorials/api/fastify" />

  <Card title="Flask" icon="ethernet" href="/pt-br/tutorials/api/flask" />

  <Card title="Laravel" icon="laravel" href="/pt-br/tutorials/api/laravel" />

  <Card title="NestJS" icon="wifi" href="/pt-br/tutorials/api/nestjs" />

  <Card title="Spring Boot" icon="leaf" href="/pt-br/tutorials/api/spring-boot" />
</CardGroup>

<Info>
  Não está na lista? Praticamente qualquer outro framework ou biblioteca também roda: se ele inicia um servidor web na porta 80, ele roda na Square Cloud.
</Info>

### Linguagens

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

  <Card title="Bun" icon="bread-slice" href="../articles/getting-started-with-bun" />

  <Card title="Deno" icon="t-rex" href="../articles/getting-started-with-deno" />

  <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" />

  <Card title="HTML/CSS" icon="html5" href="../articles/getting-started-with-html" />
</CardGroup>

## Ecossistema para desenvolvedores

Faça deploy e gerencie seu site de onde você trabalha:

* **[Square Cloud CLI](/pt-br/cli-reference/quickstart):** faça deploy, reinicie e acompanhe logs pelo terminal.
* **[Extensão para VS Code](/pt-br/vscode-extension/installation):** gerencie suas aplicações sem sair do editor.
* **GitHub:** cada push no seu repositório pode fazer deploy automaticamente, [integrando seu repositório do GitHub](https://help.squarecloud.app/pt-br/article/como-integrar-seu-repositorio-do-github-e-fazer-deploy-automatico-1nk6gr9/) ou por um [workflow do GitHub Actions](https://help.squarecloud.app/pt-br/article/workflow-github-actions-deploy-automatico-o6c7e2/).
* **[SDKs](/pt-br/sdks/introduction) e [API REST](/pt-br/api-reference/introduction):** automatize tudo o que o dashboard faz.

## Como hospedar meu site?

<Steps>
  <Step title="Adicione um arquivo de configuração" icon="file">
    Crie um arquivo `squarecloud.app` na raiz do seu projeto. O [guia do arquivo de configuração](/pt-br/getting-started/config-file) explica cada campo. Um site também precisa de:

    * **SUBDOMAIN:** o endereço do seu site. `SUBDOMAIN=test` publica o site em `test.squareweb.app`.
    * **MEMORY:** a RAM reservada para ele, **no mínimo 512 MB**.

    <Warning>Defina o `SUBDOMAIN` antes do primeiro upload. Uma aplicação enviada sem ele não pode virar um site depois: você teria que enviá-la de novo como uma nova aplicação.</Warning>
  </Step>

  <Step title="Inclua seu arquivo de dependências" icon="box">
    Mantenha o arquivo de dependências no projeto: `package.json` para Node.js, `requirements.txt` ou `pyproject.toml` para Python. A Square Cloud instala tudo o que ele lista no servidor. Deixe de fora os módulos nativos, como `fs` no Node.js ou `random` no Python, já que eles vêm com a linguagem.
  </Step>

  <Step title="Compacte o projeto" icon="file-zip">
    Compacte seu código, o arquivo de configuração e o arquivo de dependências em um `.zip`. Deixe de fora `node_modules`, `__pycache__`, lockfiles como o `package-lock.json` e outros arquivos gerados: as dependências são instaladas no servidor, e um upload menor faz o deploy mais rápido. A CLI e a extensão para VS Code já deixam os lockfiles de fora para você. Precisa de versões fixas? Adicione `!package-lock.json` ao seu arquivo [squarecloud.ignore](/pt-br/getting-started/squarecloud-ignore).
  </Step>

  <Step title="Envie seu site" icon="arrow-up">
    <Tip>Sua aplicação precisa escutar na **porta 80** e no host **`0.0.0.0`**. As imagens de runtime já definem as [variáveis de ambiente](/pt-br/platform/environment-variables) `PORT` e `HOST` com esses valores, então um servidor que as lê não precisa de nenhuma mudança. Os visitantes acessam o seu site por HTTPS, e a Square Cloud cuida do certificado.</Tip>
    Envie o `.zip` na [página de upload](https://squarecloud.app/pt-br/dashboard/new). A Square Cloud instala as dependências, prepara o ambiente a partir do seu arquivo de configuração e coloca seu site no ar.

    <Frame>
      <img src="https://cdn.squarecloud.app/docs/articles/dashboard/uploading-pt-br.gif" alt="Enviando aplicação para a Square Cloud" style={{ borderRadius: "0.2rem" }} />
    </Frame>
  </Step>
</Steps>

## Algo deu errado?

<CardGroup cols={2}>
  <Card title="O app não inicia" icon="triangle-exclamation" href="/pt-br/platform/troubleshooting/app-wont-start">
    Corrija um deploy que falha ou cai ao iniciar: uma porta já em uso, módulos ausentes, `INVALID_DEPENDENCY` ou RAM insuficiente.
  </Card>

  <Card title="Todos os guias de solução de problemas" icon="life-ring" href="/pt-br/platform/troubleshooting">
    Encontre a solução para um código de erro ou um sintoma em aplicações, bots e bancos de dados.
  </Card>
</CardGroup>

## Perguntas frequentes

<AccordionGroup>
  <Accordion title="Quanto custa hospedar um site?">
    Recomendamos o plano **Standard**, a partir de **R$44,99/mês** com 4 GB de RAM e 4 vCPUs, que também libera os domínios personalizados. Um site mais leve também roda no plano **Hobby**, a partir de **R$12,49/mês**: um site precisa de pelo menos 512 MB de RAM. Veja [Planos e Preços](/pt-br/platform/plans) para a comparação completa.
  </Accordion>

  <Accordion title="Eu ganho um subdomínio gratuito?">
    Sim. Todo deploy web inclui um subdomínio `*.squareweb.app` sem custo adicional, como parte do seu plano. Ele fica pronto para uso assim que você define o campo `SUBDOMAIN` no seu arquivo de configuração.
  </Accordion>

  <Accordion title="Posso usar meu próprio domínio?">
    Domínios personalizados estão disponíveis a partir do plano **Standard**. A Square Cloud não registra nem vende domínios: o recurso conecta um domínio que você já tem em um registrador, um hostname por aplicação (como `example.com` ou `www.example.com`). Siga [como configurar seu próprio domínio](https://help.squarecloud.app/pt-br/article/como-configurar-seu-proprio-dominio-cnamedns-j39hh2/) para os registros DNS e veja [por que um domínio ainda não propagou](https://help.squarecloud.app/pt-br/article/por-que-meu-dominio-ainda-nao-propagou-dns-3ggus4/) se ele não carregar. Para vincular pelo código, use [Definir Domínio Personalizado](/pt-br/api-reference/endpoint/apps/network/custom).
  </Accordion>
</AccordionGroup>


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