# Criar uma instalação

> Crie sua instalação na W8 Hub a partir de uma imagem Docker, um repositório GitHub ou o provisionamento assistido — sem servidor pra administrar.

_Fonte: https://w8hub.com.br/docs/criar-uma-instalacao_

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.](https://w8hub.com.br/assets/docs-26-nova-instalacao.webp)

_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](https://w8hub.com.br/docs/implantacoes#modos-de-build) — 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.](https://w8hub.com.br/assets/docs-17-github.webp)

_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.](https://w8hub.com.br/assets/docs-27-docker.webp)

_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.](https://w8hub.com.br/assets/docs-28-template.webp)

_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](https://w8hub.com.br/docs/instalacao-configuracoes#variaveis-de-ambiente), [domínios](https://w8hub.com.br/docs/dominios-e-ssl) (com SSL automático) e a **compilação**: o [Build Pack](https://w8hub.com.br/docs/implantacoes#modos-de-build) 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](https://w8hub.com.br/docs/instalacao-configuracoes).

![Aba Compilação das Configurações na W8 Hub: tipo de build (Nixpacks, Dockerfile, Static, Static SPA, Imagem Docker) e Port Expose.](https://w8hub.com.br/assets/docs-35-cfg-build.webp)

_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.](https://w8hub.com.br/assets/docs-30-revisao.webp)

_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).](https://w8hub.com.br/assets/docs-03-instalacao.webp)

_Suas instalações — cada instalação com domínio próprio, status de deploy e métricas em tempo real._