Hospedagem

• Um site é um nome e um endereço: um site chamado my-app é servido em https://my-app.espohost.com. Um projeto pode ter vários sites.
• Cada envio é um deploy: uma cópia dos seus arquivos que nunca muda. Um site mostra um deploy por vez, o ativo, então publicar uma nova versão nunca altera uma antiga.
• O Espobase serve seus arquivos como estão e não executa o seu código nos servidores de hospedagem. Para o trabalho de servidor, chame a partir da página a API REST do seu projeto ou uma edge function.

1. Abra o projeto, escolha Hospedagem no menu da esquerda e crie um site: um nome, um endereço e, para apps React, Vue e semelhantes, a opção Aplicativo de página única.
2. Clique em Publicar uma pasta e escolha a pasta de build, por exemplo dist ou out. Arquivos ocultos nunca são enviados.
3. O navegador calcula a impressão digital de cada arquivo e envia cada arquivo distinto uma só vez. Quando o envio termina, o novo deploy entra no ar.
4. Abra o endereço mostrado no cartão do site.

Com a CLI espobase, você publica uma pasta de build com um único comando:

espobase deploy ./dist --site my-app
# ✓ 42 files · 1.8 MB
# → https://my-app.espohost.com

--message adiciona uma nota ao deploy e --no-activate envia sem colocá-lo no ar. No CI, crie um token só com a permissão Fazer deploy de sites (Configurações da conta › Desenvolvedor) e passe-o como ESPOBASE_TOKEN. Esse token pode publicar, mas não pode excluir sites nem alterar as configurações deles. espobase sites list mostra seus sites.

• Em vez de enviar uma pasta, um site pode ser compilado a partir de um repositório Git público (GitHub, GitLab, Bitbucket ou Codeberg) que contenha um projeto Node. Abra o cartão do site, escolha Configurar builds, informe o repositório e a branch (e, se preciso, a pasta, os comandos e a versão do Node, 20 ou 22) e clique em Compilar agora.
• O Espobase clona o repositório, instala as dependências (conforme seu arquivo de lock: pnpm, yarn ou npm) e executa seu comando de build, cada etapa em um ambiente isolado. A pasta de saída (dist, build, out, public ou a que você definir) é publicada como um novo deploy e entra no ar.
• Um build pode usar 2 CPUs, 4 GB de memória e 10 minutos. O ambiente isolado não tem acesso ao Espobase e não guarda segredos do Espobase.
• O log aparece no cartão do site enquanto o build roda e fica guardado com ele (os 30 últimos builds são mantidos). Um site compila uma coisa por vez, e você pode cancelar um build na fila ou em andamento.
• Os builds usam os minutos de build do seu plano, arredondados para cima por build. Quando acabam, os novos builds esperam o próximo ciclo de cobrança; o site já publicado não é afetado.
• Em Variáveis de build você pode dar valores ao seu build como variáveis de ambiente. Os valores públicos (como VITE_API_URL) aparecem no painel; os segredos são criptografados, nunca mais são mostrados e ficam ocultos nos logs. Tudo o que um build coloca nos arquivos do site pode ser lido por qualquer visitante, então não use segredos em variáveis que os frameworks copiam para o site (nomes que começam com VITE_ ou NEXT_PUBLIC_).
• GitHub (Pro e Group): conecte uma conta do GitHub em GitHub na barra lateral e escolha o GitHub como origem do código nas configurações de build do site. Repositórios privados funcionam: o Espobase os lê com o app que você instalou, só durante o build. Um push na branch de produção compila e publica o site, e cada pull request do mesmo repositório recebe uma prévia no próprio endereço (pública, oculta dos buscadores, removida quando o pull request é fechado). Pull requests de forks nunca são compilados.

• O HTTPS é automático. Cada site tem seu próprio endereço em espohost.com.
• /about abre about.html e /docs abre docs/index.html. Um endereço de pasta sem a barra final redireciona para o que tem a barra.
• Adicione um 404.html para mostrar sua própria página de não encontrado. Sem ele, os visitantes veem um 404 simples.
• Com Aplicativo de página única ativado, os caminhos que não são arquivos abrem index.html, para que o roteador do seu app cuide deles. Um arquivo com extensão que não existe, como /logo.png, continua retornando 404.
• Os navegadores verificam seus arquivos de novo a cada visita (com um ETag), então um novo deploy aparece na hora. Arquivos em _next/static/ têm um hash de conteúdo do Next.js e ficam em cache por um ano.
• O tipo de conteúdo vem da extensão do arquivo.

1. Abra o cartão do site em Hospedagem, escolha Gerenciar domínios e adicione o seu domínio, por exemplo www.suamarca.com.
2. No seu provedor de DNS, publique os dois registros mostrados: um registro TXT que prova que o domínio é seu (mantenha-o publicado) e um CNAME do seu domínio para sites.espohost.com. Um domínio raiz como suamarca.com não pode ter CNAME, então publique os registros A mostrados.
3. Clique em Verificar DNS. Quando o registro TXT é encontrado, o domínio é verificado e o certificado HTTPS é emitido automaticamente na primeira visita, em poucos segundos.
4. O site agora responde no seu domínio e no endereço espohost.com. Remover um domínio o interrompe na hora.
5. Se o seu plano passar a ter menos domínios, os excedentes deixam de ser servidos, mas são mantidos.

• A largura de banda é a quantidade de dados que seus sites enviam aos visitantes. Ela é contada por ciclo de cobrança em todos os sites da sua organização e aparece na página Hospedagem.
• Você recebe um e-mail aos 75%, 90% e 100% da largura de banda do seu plano. O tráfego extra nunca é cobrado.
• Entre 100% e 125% seus sites continuam funcionando. Acima de 125%, os visitantes veem uma página de "limite de largura de banda atingido" até o próximo ciclo de cobrança começar, ou até você mudar para um plano com mais largura de banda. Nada é excluído.
• O tráfego é somado a cada minuto, então a pausa começa poucos minutos depois de passar do limite.

• Cada deploy aparece no cartão do site. Escolha Colocar no ar em um mais antigo para voltar atrás, ou em um mais novo para avançar. É instantâneo, pois só o ponteiro muda.
• O Espobase guarda os 10 deploys mais recentes de cada site e remove os mais antigos automaticamente. O deploy ativo nunca é removido.
• Desenvolvedores podem publicar e voltar atrás. Administradores criam, renomeiam e excluem sites, alteram a opção de aplicativo de página única e excluem deploys. Toda alteração fica registrada no log de auditoria.

• Tudo o que você publica é público. Não coloque segredos nos arquivos. A chave publicável é feita para ser pública e as suas regras de segurança em nível de linha protegem os dados; nunca coloque uma chave secreta em um site.
• Os sites ficam em espohost.com, um domínio diferente do Espobase, então um site não consegue ler os cookies nem os logins do Espobase.
• Cada arquivo enviado é conferido com a impressão digital e o tamanho que você declarou, e nada é servido que não esteja na lista de arquivos do deploy.

• Free: a hospedagem não está incluída.
• Pro: 10 sites por projeto, 10 GB de arquivos hospedados, 1 domínio próprio por site, 250 GB de largura de banda por mês, 500 minutos de build por mês.
• Group: 50 sites por projeto, 100 GB de arquivos hospedados, 5 domínios próprios por site, 1 TB de largura de banda por mês, 2.000 minutos de build por mês.
• Um deploy pode ter até 10.000 arquivos, 50 MB por arquivo e 500 MB no total. Um envio que não termina em uma hora expira.
• Os arquivos hospedados são contados em toda a sua organização. Se você mudar para um plano com menos sites, os sites excedentes deixam de ser servidos, mas nada é excluído.

• Apps renderizados no servidor (como Next.js com servidor). As exportações estáticas funcionam hoje.