Documentação da W8 Hub

Infraestrutura de software gerenciada, no Brasil. Você publica sua aplicação em container (Docker) e a W8 Hub cuida de deploy, banco de dados, armazenamento, domínios, SSL, backups, observabilidade e segurança desde o primeiro dia.

Comece pelo deploy em 5 minutos, entenda os conceitos da plataforma e aprofunde nas áreas pela navegação à esquerda.

Introdução

A W8 Hub é uma plataforma de infraestrutura de software gerenciada. O princípio é o scaling transparente: você começa simples com seu Docker e cresce com recursos gerenciados (bancos, armazenamento, domínios, observabilidade) sem montar um time de infraestrutura.

Por que times escolhem a W8 Hub:

• Preço em reais: sem variação cambial, sem dólar e sem IOF.
• Dados no Brasil: conformidade com a LGPD e menor latência.
• Suporte humanizado em português.
• Comprovado: +400 instalações no ar, uptime acima de 99,9% e cerca de 60% mais barato que um time de DevOps interno.

Criar conta e primeiro acesso

Todo o gerenciamento acontece no painel em dev.w8hub.com.br.

1. Crie sua conta e faça login. Se você foi convidado para uma organização, aceite o convite pelo link recebido (veja Membros e convites).
2. Onboarding: no primeiro acesso você cria sua organização e seu primeiro projeto.
3. Seu perfil: ajuste nome, foto (avatar) e senha a qualquer momento nas configurações da conta.

Esqueceu a senha? Use o fluxo de redefinição de senha na tela de login — você recebe um link por e-mail para definir uma nova.

Deploy em 5 minutos

O caminho mais rápido é apontar uma imagem Docker ou um repositório do GitHub. A W8 Hub faz o build, sobe o container, provisiona SSL e entrega uma URL pública.

1. Crie um projeto

No painel, dentro da sua organização, crie um projeto (ex.: Produção).

2. Crie o recurso

Escolha a origem da aplicação (veja Criar um recurso): imagem Docker, repositório GitHub público, ou o assistente de provisionamento.

Um Dockerfile mínimo para uma app Node, por exemplo:

FROM node:20-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --omit=dev
COPY . .
EXPOSE 3000
CMD ["node", "server.js"]

3. Configure porta e variáveis

Exponha a porta que sua aplicação escuta e cadastre as variáveis de ambiente (ex.: DATABASE_URL).

4. Publique

Dispare o deploy. Ao final, a aplicação recebe uma URL com HTTPS automático. A partir daí você acompanha logs e métricas e pode conectar um domínio próprio.

Conceitos: Organização → Projeto → Recurso

Toda a conta é organizada em três níveis. Entender essa hierarquia ajuda a navegar no painel.

Migrar de Heroku, Render ou Vercel

Se você está em Heroku, Vercel, Render ou em servidor próprio, a migração costuma ser direta: sua aplicação já roda em container ou tem um Dockerfile.

1. Empacote em Docker (se ainda não estiver).
2. Provisione o banco gerenciado na W8 Hub e restaure seu dump.
3. Recrie as variáveis de ambiente no recurso.
4. Aponte seu domínio e valide o SSL automático.
5. Vire o tráfego quando tudo estiver verde.

Você ganha preço em reais, dados no Brasil sob LGPD e suporte em português.

Criar um recurso

Um recurso é a sua aplicação rodando em container. Você pode criá-lo de três formas:

• Imagem Docker: aponte uma imagem já publicada em um registro.
• GitHub público: informe a URL de um repositório público e a W8 Hub faz o build.
• Provisionamento assistido: um assistente guia a criação a partir de modelos.

Para repositórios privados, conecte sua conta do GitHub à organização.

Conectar o GitHub

Conecte o GitHub à sua organização para fazer deploy de repositórios privados e sincronizar branches.

1. Conecte a conta/organização do GitHub nas Integrações.
2. Escolha o repositório e a branch — a W8 Hub lê a árvore de arquivos e branches disponíveis.
3. Crie o recurso a partir do repositório dentro de um projeto.
4. Faça deploy a partir de uma branch/commit; sincronize as fontes quando adicionar novos repositórios.

Como funciona o deploy

Cada deploy gera uma nova versão do recurso. No painel você acompanha o histórico de deployments e os logs de cada um.

• Disparar deploy: manualmente ou a partir de um push no GitHub conectado.
• Histórico: veja todas as versões e o detalhe de cada deployment.
• Voltar versão: reimplante um deployment anterior quando precisar reverter uma mudança.

Variáveis de ambiente

As variáveis pertencem ao recurso e ficam disponíveis para o container em tempo de execução. Você pode criá-las, editá-las e removê-las individualmente ou em lote.

Ciclo de vida do recurso

Cada recurso pode ser iniciado, parado e reiniciado pelo painel, além de atualizado (configurações, domínio) ou removido. Use parar para pausar sem excluir e reiniciar para aplicar mudanças que exigem restart.

Atividades

Cada recurso, projeto e organização tem um feed de atividades com o que aconteceu — deploys, mudanças de configuração, ações de membros. Use para entender o histórico operacional e depurar o que mudou e quando. Para eventos com autor e detalhe de segurança, veja também Logs de auditoria.

Acesso FTP

Quando o recurso precisa de acesso a arquivos, você pode gerar credenciais de FTP para ele pelo painel e consultá-las quando necessário. Útil para enviar/baixar arquivos sem reconstruir a imagem.

Domínios & SSL

Todo recurso nasce com um domínio da plataforma. Conecte também domínios próprios, com SSL/HTTPS automático.

1. Adicione o domínio à organização.
2. Aponte o DNS conforme as instruções exibidas (registro/alvo).
3. Verifique o domínio — o certificado SSL é emitido e renovado automaticamente.
4. Vincule ao recurso (attach) e, se tiver mais de um, defina o primário.

Você pode desvincular (detach) ou remover um domínio quando quiser. Para gerenciar o DNS direto pela W8 Hub, use a integração com a Cloudflare.

Proxy: autenticação, CORS, headers, rate limit

Cada recurso tem um proxy de entrada configurável, sem precisar mexer na aplicação. Pelo painel você define:

Bancos de dados — visão geral e engines

Provisione bancos gerenciados sem administrar servidor. O banco pertence a um projeto e pode ser criado, editado, iniciado, parado e reiniciado pelo painel; você também acompanha o tamanho em disco.

• Engines: PostgreSQL, MySQL, Redis e MariaDB.
• Conexão: use a string de conexão do banco nas variáveis de ambiente do recurso.

Contas e SQL no painel

Cada banco tem contas de acesso (usuários) que você gerencia pelo painel:

• Criar e remover contas e redefinir senha.
• Explorar o schema e listar tabelas.
• Rodar consultas SQL direto do painel.
• Habilitar extensões (ex.: no PostgreSQL).

Backups e restauração

Backups gerenciados por banco: agende a política, dispare um backup sob demanda, acompanhe as execuções, faça download e restaure a partir de um backup. A retenção acompanha o plano (veja Escala e planos).

Armazenamento S3 — buckets e visibilidade

Crie buckets compatíveis com S3 para arquivos, uploads e artefatos. Pelo painel você cria, edita e remove buckets e define:

• Visibilidade: bucket público ou privado.
• CORS: regras de acesso a partir do navegador.

Credenciais e objetos

• Credenciais S3: obtenha as chaves de acesso do bucket e regenere quando precisar rotacionar — use com qualquer SDK/cliente S3.
• Navegador de objetos: liste, busque, visualize e exclua objetos pelo painel.
• URLs pré-assinadas: gere links temporários para upload/download seguro sem expor as credenciais.

Integrações: GitHub e Cloudflare

Conecte serviços externos à sua organização e gerencie as integrações (listar, editar, remover) em um só lugar.

GitHub

Conecte contas/organizações do GitHub para fazer deploy de repositórios e sincronizar fontes. Veja Conectar o GitHub.

Cloudflare (DNS)

Conecte sua conta Cloudflare para gerenciar DNS direto da W8 Hub: liste zonas, crie, edite e remova registros, resolva a zona de um domínio e rotacione o token da integração quando necessário — útil para automatizar o apontamento dos seus domínios.

Webhooks

Receba notificações de eventos da W8 Hub no seu próprio endpoint (para integrar com Slack, sistemas internos, automações). Por organização você pode:

• Criar webhooks apontando para uma URL e escolher os eventos (consulte o catálogo de eventos).
• Acompanhar entregas: veja o histórico de cada disparo e reenvie uma entrega que falhou.
• Testar o webhook e reativá-lo caso seja desativado por falhas seguidas.
• Rotacionar o segredo usado para assinar os payloads.

Tokens de API

Gere tokens de API por organização para automatizar a plataforma (CI/CD, scripts, agentes de IA). No painel da organização você cria, lista e revoga tokens; o valor é exibido uma única vez — guarde em local seguro.

Métricas

Acompanhe o desempenho em vários níveis: por recurso, por projeto e pela organização inteira. As métricas incluem uso de CPU e memória, requisições HTTP (com classe de status) e os containers em execução.

Logs

Veja os logs do recurso em tempo real e o volume de logs ao longo do tempo, direto do painel — sem configurar coletor.

Health checks

A W8 Hub monitora a saúde de cada recurso e sinaliza quando algo sai do ar, alimentando alertas e a status page.

Status page

Publique uma página de status pública da sua organização (acessível sem login) para comunicar disponibilidade aos seus clientes. Você configura o que aparece na página pelo painel.

Alertas

Crie regras de alerta por organização a partir de um catálogo de métricas monitoráveis — CPU, memória, disco, uptime, HTTP, SSL, deploy e status. Edite ou remova regras quando quiser.

Incidentes

Acompanhe o histórico de incidentes por organização e por recurso — o que aconteceu, quando começou e quando foi resolvido.

Membros e convites

Gerencie quem acessa sua organização:

• Convide membros por e-mail; eles aceitam (ou recusam) pelo link recebido.
• Veja seus convites pendentes e a lista de convites da organização.
• Gerencie membros: altere o papel de um membro ou remova o acesso.

Papéis e permissões

O acesso é controlado por papéis (RBAC): cada membro tem um papel na organização que define o que pode ver e fazer. Grupos de permissão avançados fazem parte do plano Enterprise. Em breve

Segurança da plataforma

Segurança gerenciada por padrão: isolamento entre recursos, certificados, firewall e proteção contra DDoS, além dos controles de proxy (auth, rate limit, IP allow list) por recurso. Dados hospedados no Brasil sob a LGPD. Veja também a página de Segurança e o modelo de Responsabilidade Compartilhada.

Logs de auditoria

A organização mantém logs de auditoria das ações realizadas, para rastreabilidade e conformidade. A retenção estendida acompanha o plano Enterprise.

Escala e planos

Comece pequeno e cresça ajustando o recurso ao seu tráfego. O dimensionamento de CPU/RAM segue o plano e o tipo de recurso; recursos avançados de operação (alta disponibilidade, réplicas, multi-região e multi-cloud) são addons Enterprise, ativados junto ao time.

Addons Enterprise: R$ 2.000/mês (permissões e logs de auditoria), R$ 5.000/mês (suporte com SLA e limites maiores) e R$ 10.000/mês (Firewall L3 e servidores dedicados). Tabela completa em Planos e preços.

API REST

Tudo o que você faz no painel também roda pela API — ideal para CI/CD, automações e agentes de IA. A referência completa e sempre atualizada (autenticação, endpoints, campos e exemplos) fica na documentação da própria API:

Suporte

Suporte humanizado em português. Para dúvidas, habilitação de token de API ou uma visão da plataforma no seu caso de uso:

• Agende uma demo ou comece grátis.
• Painel: dev.w8hub.com.br
• Visão geral para LLMs: /llms.txt · Guia de integração de IA: /ia