Como usar o Node.js Selector do cPanel para rodar uma aplicação Node imprimir

Como usar o Node.js Selector do cPanel para rodar sua aplicação Node

Olá! Aqui é a Sensei da GeHost 🧘 Se você tem uma aplicação feita em Node.js (Express, um bot, uma API, o que for) e quer colocá-la no ar dentro da sua hospedagem cPanel, você não precisa mexer em linha de comando complicada nem depender de suporte técnico externo. O cPanel tem uma ferramenta pronta pra isso, chamada "Setup Node.js App" (Node.js Selector). Vamos passo a passo, com calma, do jeitinho que dá pra qualquer pessoa entender.

Dica da Sensei: a disponibilidade e as versões de Node.js oferecidas pelo Node.js Selector dependem da configuração do seu plano no servidor. Se você não encontrar a ferramenta no seu cPanel, fale com o suporte pelo painel.gehost.com.br para confirmar se ela está habilitada na sua conta.

1. Acesse o cPanel

Entre no seu cPanel normalmente (pelo link de acesso enviado na entrega da sua hospedagem, ou pelo endereço próprio do seu domínio). Na tela inicial, você verá vários grupos de ferramentas organizados por categoria.

2. Encontre o "Setup Node.js App"

Use a barra de busca no topo do cPanel e digite "Node", ou procure a seção de Software. Clique no ícone Setup Node.js App (também aparece como "Node.js Selector").

3. Crie sua aplicação

Dentro da ferramenta, clique em "Create Application" (Criar Aplicação) e preencha os campos:

• Node.js version: escolha a versão do Node compatível com o seu projeto (veja no package.json da sua aplicação se há alguma exigência de versão).
• Application mode: em produção, use "Production". "Development" é só para testes.
• Application root: a pasta onde os arquivos da sua aplicação vão ficar (ex.: minhaapp). Não use a public_html diretamente — crie uma pasta específica.
• Application URL: o domínio ou subdomínio que vai acessar essa aplicação.
• Application startup file: o arquivo principal que inicia sua aplicação (geralmente app.js, server.js ou index.js).

Depois clique em "Create". O cPanel vai criar automaticamente um ambiente virtual isolado para rodar seu Node.

4. Envie os arquivos da sua aplicação

Agora é hora de colocar o código da sua aplicação dentro da pasta que você definiu como "Application root". Use o Gerenciador de Arquivos do cPanel (ou envie via FTP, se preferir) para subir todos os arquivos do projeto, incluindo o package.json.

5. Instale as dependências

Volte na tela do Setup Node.js App e abra a sua aplicação criada. Você vai ver um botão chamado "Run NPM Install" — clique nele. O cPanel vai ler o seu package.json e instalar automaticamente todos os pacotes (dependências) que sua aplicação precisa, sem você precisar digitar comando nenhum.

Dica da Sensei: se você preferir usar o terminal, o cPanel mostra um comando do tipo "Enter to the virtual environment" — copiando e colando esse comando você entra no ambiente certinho da sua aplicação e pode rodar comandos npm manualmente.

6. Configure variáveis de ambiente (se precisar)

Se a sua aplicação usa variáveis de ambiente (como chaves de API, portas, configurações de banco), adicione-as na seção "Environment variables" dentro da própria tela de edição da aplicação, no formato "chave" e "valor". Depois salve.

7. Inicie (ou reinicie) a aplicação

Com tudo configurado, clique em "Start App" (ou "Restart" se ela já estiver rodando). Sempre que você alterar arquivos, variáveis de ambiente ou instalar novas dependências, lembre-se de clicar em "Restart" para que as mudanças entrem em vigor.

8. Teste no navegador

Acesse o domínio ou subdomínio configurado na "Application URL" pelo navegador. Se tudo deu certo, sua aplicação Node estará no ar! 🎉

Problemas comuns

• A página não carrega ou dá erro 503: verifique se o "Application startup file" está com o nome correto e se o arquivo realmente existe na pasta.
• Erro relacionado a módulos não encontrados: volte na tela do Setup Node.js App e clique novamente em "Run NPM Install".
• Mudanças no código não aparecem: lembre-se de clicar em "Restart" depois de qualquer alteração.
• Versão do Node incompatível: confira no package.json do seu projeto (campo engines, se houver) qual versão é recomendada e selecione a mesma no passo 3.

Se mesmo seguindo os passos sua aplicação não subir, não se preocupe — entre em contato com o suporte pelo painel.gehost.com.br e leve o máximo de detalhes possível (qual erro aparece, qual versão do Node, e o que a aplicação faz). Assim conseguimos te ajudar mais rápido. Até a próxima! 🌱