Como configurar um ambiente Node.js na sua hospedagem GeHost
Oi! Eu sou a Sensei da GeHost 🌱 e hoje vou te mostrar, com calma e sem enrolação, como colocar uma aplicação Node.js rodando na sua hospedagem. Uma coisa importante antes de começarmos: os planos da GeHost são hospedagem em cPanel, e é justamente o cPanel que traz uma ferramenta pronta para rodar Node.js — o Setup Node.js App — sem que você precise mexer em servidor, terminal avançado ou ter acesso root. Ou seja: dá, sim, para rodar sua aplicação Node.js na GeHost, e o caminho é mais simples do que parece.
Dica da Sensei: se você não sabe se o seu plano já vem com suporte a Node.js habilitado, é só entrar em contato com o suporte da GeHost ou verificar diretamente no seu painel — cada conta pode ter uma configuração específica.
1. Acesse o cPanel
Tudo começa no seu cPanel, o painel de controle da sua hospedagem. Você recebeu o link de acesso e as credenciais por e-mail quando contratou o serviço — geralmente algo como seudominio.com/cpanel. Digite seu usuário e senha e entre.
Depois do login, você vai cair na tela inicial, com vários grupos de ferramentas organizados por categoria (E-mail, Arquivos, Bancos de Dados etc.).
2. Encontre o "Setup Node.js App"
Use a busca no topo do cPanel e digite "Node". Vai aparecer a opção Setup Node.js App (às vezes traduzida como "Configurar Aplicativo Node.js"). Clique nela.
3. Crie a sua aplicação
Dentro da ferramenta, clique em Create Application (ou "Criar Aplicativo") e preencha:
- Node.js version: escolha a versão do Node que o seu projeto precisa (se não souber, verifique no arquivo
package.jsonou pergunte para quem desenvolveu a aplicação). - Application mode: use Production para o site já em funcionamento no ar.
- Application root: a pasta dentro da sua hospedagem onde os arquivos do projeto vão ficar (ex.:
meuapp). - Application URL: o domínio ou subdomínio que vai acessar essa aplicação.
- Application startup file: geralmente é o
app.jsouindex.jsdo seu projeto.
Clique em Create para salvar.
4. Envie os arquivos do seu projeto
Com a aplicação criada, é hora de subir o código. Use o Gerenciador de Arquivos do cPanel (ou um cliente FTP, se preferir) e envie tudo para a pasta que você definiu como "Application root".
Dica da Sensei: se o seu projeto estiver compactado em um .zip, envie o arquivo compactado e depois use a opção "Extract" do próprio Gerenciador de Arquivos — é bem mais rápido do que enviar arquivo por arquivo.
5. Instale as dependências
Volte para a tela do Setup Node.js App, abra a sua aplicação e clique em Run NPM Install. Isso vai instalar automaticamente tudo que está listado no seu package.json, sem precisar de linha de comando.
6. Configure as variáveis de ambiente (se precisar)
Se o seu projeto usa variáveis como chaves de API, senhas de banco ou portas específicas, adicione-as na seção Environment variables, dentro da própria tela de configuração da aplicação. Assim você evita deixar informações sensíveis direto no código.
7. Inicie (ou reinicie) a aplicação
Com tudo configurado, clique em Start App (ou Restart, se ela já estava rodando). Pronto — sua aplicação Node.js está no ar!
8. Teste no navegador
- Acesse o domínio ou subdomínio que você configurou como "Application URL".
- Confirme se a aplicação carrega corretamente.
- Se algo der errado, volte na tela do Setup Node.js App e verifique o log de erros disponível ali mesmo.
Dica da Sensei: sempre que atualizar o código do seu projeto (nova versão, correção de bug), lembre-se de rodar o "Run NPM Install" de novo (se mudou dependências) e clicar em "Restart" para a aplicação carregar as mudanças.
Precisa de ajuda?
Se em algum passo você travar, sem problema — é para isso que estamos aqui. Fale com o suporte da GeHost pelo seu painel de cliente ou verifique os detalhes do seu plano para confirmar os recursos disponíveis. Boa sorte com o seu projeto, e conte com a gente! 🚀
