# Configurações > Configure sua instalação na W8 Hub: variáveis de ambiente, watch paths, health checks e acesso FTP — tudo pelo painel, sem reconstruir a imagem. _Fonte: https://w8hub.com.br/docs/instalacao-configuracoes_ A aba **Configurações** reúne, em seções à esquerda, tudo que define *como* a instalação roda: nome e slug, **variáveis de ambiente**, **domínios**, **compilação** (build, porta e os caminhos observados para redeploy) e as **verificações de saúde**. Em instalações que lidam com arquivos, é aqui também que você libera o **acesso FTP**. ![Aba Configurações de uma instalação na W8 Hub, seção Geral: nome da instalação e slug.](https://w8hub.com.br/assets/docs-31-cfg-geral.webp) _Configurações — as seções que definem como a instalação roda (aqui, a Geral: nome e slug)._ ## Variáveis de ambiente As variáveis pertencem à instalação 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**, colando um bloco no formato `CHAVE=valor`: ``` DATABASE_URL=postgres://usuario:senha@host:5432/meubanco REDIS_URL=redis://host:6379 NODE_ENV=production ``` > [!WARNING] > **Boa prática:** trate segredos como segredos. Nunca faça commit de `.env` — cadastre-os como variáveis da instalação. ![Seção Variáveis de Ambiente das Configurações de uma instalação na W8 Hub: adicionar variáveis uma a uma ou importar um arquivo .env em lote.](https://w8hub.com.br/assets/docs-32-cfg-envs.webp) _Variáveis de ambiente — adicione uma a uma ou importe um `.env` em lote._ ## Domínios Na seção **Domínios** você define em quais endereços a instalação responde. Toda instalação já nasce com um **domínio automático da plataforma**; a partir daí você pode **gerar outro** ou **vincular o seu próprio**, com **SSL automático** em todos eles. O passo a passo de DNS e SSL está em [Domínios & SSL](https://w8hub.com.br/docs/dominios-e-ssl). - **Vários domínios na mesma instalação:** você não fica preso a um só. Adicione quantos quiser — um **principal** e os demais como **secundários** (aliases). Serve para migrar de um endereço antigo para um novo, atender `seudominio.com.br` e `www.seudominio.com.br` juntos, ou expor a mesma aplicação em marcas/endereços diferentes. - **Um domínio para cada cliente (multi-tenant):** se a sua aplicação atende vários clientes, aponte o **domínio de cada cliente** para a **mesma instalação** — `cliente-a.com.br`, `cliente-b.com.br`, e assim por diante. A W8 Hub emite o SSL de cada um automaticamente e a sua aplicação identifica o cliente pelo domínio (o *host*) da requisição. > [!TIP] > Cada domínio adicionado ganha **HTTPS/SSL automático e gratuito** — inclusive os secundários e os de cada cliente. Você só precisa [apontar o DNS](https://w8hub.com.br/docs/dominios-e-ssl) uma vez por domínio. ![Seção Domínios das Configurações de uma instalação na W8 Hub: seletor de domínios com a opção de gerar um domínio automático e de adicionar domínios próprios (principal e secundários).](https://w8hub.com.br/assets/docs-33-cfg-dominios.webp) _Domínios — gere um domínio automático ou adicione os seus (principal e secundários); um por cliente aponta todos para a mesma instalação._ ## Watch Paths Com o [deploy automático](https://w8hub.com.br/docs/implantacoes) ligado, **todo push** na branch conectada gera uma nova implantação — mesmo quando a mudança não tem nada a ver com aquela instalação. Os **Watch Paths**, na seção **Compilação**, filtram isso: você informa **quais caminhos do repositório a W8 Hub deve observar** e só as mudanças dentro deles disparam o redeploy. Preencha o campo com os caminhos **separados por vírgula**: ``` apps/api, packages/shared, package.json ``` - **Campo vazio:** comportamento padrão — qualquer push na branch conectada dispara o deploy. - **Com caminhos preenchidos:** o push só vira implantação se o commit tocar em pelo menos um deles; se não tocar, a W8 Hub ignora o push e a instalação segue na versão que já está no ar. - **Valem por instalação:** cada uma tem os seus caminhos, então o mesmo repositório pode alimentar várias instalações com gatilhos diferentes. ![Seção Deploy & Redirect das Configurações de uma instalação na W8 Hub: campo Watch Paths com caminhos separados por vírgula que disparam o auto-deploy, ao lado do Redirect e do Health Check.](https://w8hub.com.br/assets/docs-59-watch-paths.webp) _Watch Paths — informe os caminhos separados por vírgula que disparam o deploy automático a cada push._ > [!TIP] > Onde isso mais compensa é no **monorepo**. Com API, front e workers no mesmo repositório — cada um na sua instalação —, um commit no front reconstrói também a API e os workers. Apontando `apps/api` na instalação da API e `apps/web` na do front, cada push reconstrói só quem mudou: menos fila de build, menos tempo de build consumido do plano e menos deploy desnecessário em produção. > [!WARNING] > **Lembre das dependências compartilhadas.** Se a sua API importa `packages/shared`, liste os dois caminhos — senão uma mudança só no pacote compartilhado não dispara o deploy da API. O filtro vale para os deploys disparados por push: o **Novo Deploy** manual e a reimplantação de uma versão continuam funcionando normalmente. Para montar os caminhos sem digitar tudo à mão, o campo abre um **seletor de caminhos**: navegue pela árvore do repositório e escolha a pasta ou o arquivo a observar, ou digite o caminho direto no filtro. ![Seletor de caminhos do Watch Paths na W8 Hub: navegador da árvore do repositório com a opção de selecionar a pasta raiz ou arquivos específicos para observar.](https://w8hub.com.br/assets/docs-60-watch-paths-editor.webp) _Seletor de caminhos — navegue pelo repositório e escolha o que observar, ou digite o caminho no filtro._ ## Health checks A W8 Hub monitora a **saúde** de cada instalação e sinaliza quando algo sai do ar, alimentando alertas e a status page. - **Detecção automática** de indisponibilidade — e, se quiser, **ative um health check configurável** na instalação para checagens mais finas. - **Alimenta os [alertas](https://w8hub.com.br/docs/alertas)** e a [status page](https://w8hub.com.br/docs/status-page) em tempo real. Assim você fica sabendo no primeiro sinal de instabilidade, antes do seu cliente. > [!WARNING] > **Recomendação: ative um health check em toda instalação antes de subir para produção.** Ele é a rede de segurança do seu deploy — a W8 Hub passa a validar continuamente se a aplicação está respondendo e, se um deploy subir com problema, você é avisado na hora pelos [alertas](https://w8hub.com.br/docs/alertas) e na [status page](https://w8hub.com.br/docs/status-page). ![Configuração de Health Check de uma instalação na W8 Hub, com gatilhos de pré e pós-implantação.](https://w8hub.com.br/assets/docs-21-health.webp) _Health Check — ative verificações automáticas de saúde do container, além dos gatilhos de deploy._ ## Acesso FTP Em instalações que trabalham com arquivos — como um **WordPress** — a aba **Arquivos** da instalação **gera para você uma URL de FTP pronta** (a W8 Hub monta host, usuário e senha). Você não precisa configurar nada à mão: é só usar a URL num cliente FTP para gerenciar os arquivos, sem reconstruir a imagem do container. 1. **Abra a aba *Arquivos*** na tela da instalação e clique em **Gerar Credenciais** — a W8 Hub gera na hora a **URL de FTP**, exclusiva daquela instalação. 2. **Use a URL gerada** num cliente FTP (como o **FileZilla**) — a plataforma já entrega host, usuário e senha prontos. 3. **Gerencie arquivos, temas e plugins** e faça upload ou download direto pelo cliente. 4. **Rotacione ou revogue** a URL/credenciais quando precisar cortar o acesso. Ideal para ajustes pontuais, upload de mídia e manutenção de temas e plugins sem refazer o deploy. ![Gerenciador de arquivos de uma instalação WordPress na W8 Hub: a plataforma gera uma URL de FTP pronta para acesso.](https://w8hub.com.br/assets/docs-25-ftp.webp) _Acesso FTP — a W8 Hub gera a URL de FTP pronta; é só usá-la num cliente como o FileZilla para gerenciar arquivos, temas e plugins._ ## Excluir a instalação No fim das **Configurações** fica a **Zona de Perigo**. Ali você pode **excluir a instalação definitivamente**: a W8 Hub derruba o container, libera os recursos e remove a configuração. Para confirmar, normalmente é preciso **digitar o nome** da instalação. > [!WARNING] > **A exclusão é irreversível e não apaga o que é separado.** Antes de excluir: (1) se a app usa um [banco](https://w8hub.com.br/docs/bancos-de-dados), faça um [backup](https://w8hub.com.br/docs/bancos-backups) — o banco é um recurso à parte e não é removido junto; (2) libere os [domínios](https://w8hub.com.br/docs/dominios-e-ssl) vinculados se for reutilizá-los em outra instalação. Se só quer pausar sem perder nada, use **Parar** no [ciclo de vida](https://w8hub.com.br/docs/instalacao-geral).