Criar uma instalação

Uma instalação é a sua aplicação rodando em container. Dentro de um projeto, clique em Nova instalação para abrir o assistente — 4 passos: Escolher método → Configurar → Configurações → Revisão.

Página Suas instalações na W8 Hub com o botão Nova instalação em destaque no topo e a lista de instalações com domínio, status e métricas. — Botão **Nova instalação** — o ponto de partida, no topo da lista de instalações do projeto.

No primeiro passo, escolha a origem do código: GitHub, uma imagem Docker ou um template pronto.

A partir do GitHub

Repositório privado (via GitHub App) ou público (cole a URL). Escolha a conta, o repositório, a branch e o Build Pack — os deploys passam a rodar a cada push.

Dois pré-requisitos do fluxo GitHub: (1) a integração do GitHub precisa estar conectada antes — sem ela, seus repositórios (sobretudo os privados) não aparecem para seleção; (2) a branch informada precisa já existir no repositório — a W8 Hub lê as branches direto do GitHub, ela não cria a branch para você.

Passo Configurar GitHub na W8 Hub: repositório privado ou público, conta do GitHub App, seleção de repositório e branch. — Método GitHub — repositório privado (GitHub App) ou público, com conta, repositório, branch e Build Pack.

A partir de uma imagem Docker

Escolha o provedor de registro (ex.: Docker Hub) e informe a URL da imagem com a tag (ex.: docker.io/library/nginx:latest), além da porta. A imagem já vem pronta — não há build (por isso não há Build Pack aqui).

Passo Configurar Docker na W8 Hub: provedor de registro (Docker Hub) e campo de URL da imagem com a tag. — Método Imagem Docker — escolha o registro e informe a imagem:tag; a imagem já vem pronta, sem build.

A partir de um template

Provisione ferramentas prontas em um clique — WordPress, n8n, Metabase, NocoDB, Chatwoot, Strapi, Typebot, Evolution API e mais, com banco já incluso quando necessário. Selecione um ou mais templates do catálogo e siga para as configurações.

Passo Selecionar Templates na W8 Hub: catálogo com n8n, Evolution API, Mautic, Chatwoot, Typebot, Open WebUI, NocoDB, Metabase, WordPress e mais. — Método Template — escolha uma ferramenta pronta do catálogo (n8n, Evolution API, Chatwoot, NocoDB, WordPress…) e instale em um clique.

Configurar, revisar e publicar

Escolhido o método, o assistente segue para as Configurações — nome e slug, variáveis de ambiente, domínios (com SSL automático) e a compilação: o Build Pack e a Port Expose (a porta em que sua aplicação escuta). Passo a passo de cada seção em Configurações da instalação.

Aba Compilação das Configurações na W8 Hub: tipo de build (Nixpacks, Dockerfile, Static, Static SPA, Imagem Docker) e Port Expose. — Compilação — o Build Pack, a porta (Port Expose), o pipeline e o health check.

Por fim, a etapa de Revisão mostra o resumo de origem, build e infraestrutura. Confira e clique em Finalizar e Deploy.

Passo Revisão Técnica no assistente da W8 Hub: resumo de origem e build, infraestrutura, dependências e pipeline antes do deploy, com o botão Finalizar e Deploy. — Revisão — valide origem/build, infraestrutura e o **Health Check** e clique em *Finalizar e Deploy*.

Antes de considerar o deploy pronto, ative um health check na instalação. É o que garante que a nova versão subiu de fato saudável: com ele, a W8 Hub identifica na hora um deploy quebrado e dispara os alertas, em vez de você descobrir o problema pelo cliente.

Pronto — a W8 Hub builda, sobe o container, provisiona o SSL e entrega a URL. Sua instalação passa a aparecer na lista do projeto, com domínio, status de deploy e métricas em tempo real.

Lista de instalações de um projeto: cada instalação com domínio, status de deploy, commit e métricas (CPU, RAM, rede). — Suas instalações — cada instalação com domínio próprio, status de deploy e métricas em tempo real.

Anterior← Conceitos: Org, Projeto, Instalação PróximoGeral →