Como configurar um ambiente Node.js na sua hospedagem GeHost
Oi! Aqui é a Sensei da GeHost 🌱 Se você tem uma aplicação em Node.js (aquele projeto com package.json, Express, API própria etc.) e quer colocá-la no ar, vim te mostrar o caminho mais tranquilo: a ferramenta "Configurar App Node.js", disponível direto no seu cPanel. Nada de comando complicado em terminal — a gente faz tudo pelo painel, com calma, passo a passo.
Antes de começar: sua hospedagem cPanel na GeHost já vem preparada para rodar aplicações Node.js através dessa ferramenta do painel, sem você precisar mexer em configurações de servidor por fora. É tudo guiado.
O que você vai precisar antes de começar
- Seu usuário e senha de acesso ao cPanel (chegam por e-mail na entrega da sua hospedagem).
- Os arquivos do seu projeto Node.js (pasta com
package.json, seu código-fonte etc.), prontos em um .zip ou organizados numa pasta. - Saber qual é o arquivo de entrada da sua aplicação (geralmente
app.js,server.jsouindex.js— pergunte pra quem desenvolveu, se não souber).
Passo 1 — Acesse o cPanel
Entre no seu cPanel normalmente com o usuário e senha da sua hospedagem.
Passo 2 — Encontre "Configurar App Node.js"
Já dentro do painel, use a busca no topo (ou role a tela) até achar a ferramenta chamada "Configurar App Node.js" ou "Setup Node.js App", geralmente na seção de Software.
Passo 3 — Crie a sua aplicação
Clique em "Criar Aplicação" e preencha os campos:
- Versão do Node.js: escolha uma das versões disponíveis na lista da tela (fique com uma versão estável, se não tiver certeza).
- Raiz da aplicação (Application root): o nome da pasta onde os arquivos do seu projeto vão ficar (ex.:
minha-api). - URL da aplicação: o domínio ou subdomínio onde ela vai responder.
- Arquivo de inicialização (Startup file): o nome do arquivo de entrada do seu projeto (ex.:
app.js).
Depois é só clicar em Criar. O cPanel vai gerar a estrutura da aplicação pra você.
Passo 4 — Envie os arquivos do seu projeto
Agora é hora de colocar seu código dentro da pasta que você definiu como "raiz da aplicação". Você pode fazer isso pelo Gerenciador de Arquivos do cPanel (enviando um .zip e extraindo) ou por FTP, se preferir.
Dica da Sensei: envie o projeto compactado em .zip, é bem mais rápido do que enviar arquivo por arquivo — depois é só clicar em "Extrair" dentro do próprio Gerenciador de Arquivos.
Passo 5 — Instale as dependências
Volte para a tela "Configurar App Node.js", clique na sua aplicação já criada e procure o botão "Executar comando NPM Install" (ou algo equivalente, conforme o texto do seu painel). Isso vai instalar automaticamente tudo que está listado no seu package.json — sem precisar digitar comando nenhum.
Passo 6 — Inicie e teste a aplicação
Ainda na mesma tela, clique em "Iniciar aplicação" (ou "Restart", se ela já estiver rodando). Depois, acesse a URL/domínio que você configurou no Passo 3 pelo navegador e veja se sua aplicação está respondendo certinho.
Se a página não carregar de primeira, respira 🙂 confira se o "arquivo de inicialização" está com o nome certo e se ele realmente está dentro da pasta raiz que você definiu — esse é o erro mais comum nessa etapa.
Precisa de uma força extra?
Você tem 30 dias de suporte gratuito após a entrega da sua hospedagem — aproveite esse período pra tirar qualquer dúvida na configuração do seu ambiente Node.js. Qualquer coisa, acompanhe sua conta e abra um chamado pelo painel.gehost.com.br. Estamos por aqui torcendo pelo seu projeto! 💚
