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 e quer colocá-la pra rodar dentro da sua hospedagem, o caminho mais simples é o Node.js Selector, uma ferramenta que já vem dentro do seu cPanel. Ela cuida da parte técnica mais chata (versão do Node, variáveis de ambiente, proxy) pra você focar só na sua aplicação. Vamos passo a passo, com calma.

Antes de começar: o Node.js Selector serve para aplicações Node.js "normais" (Express, APIs, bots, etc.) rodando dentro da sua hospedagem cPanel. Se tiver dúvida se o seu projeto é compatível, fale com o suporte antes de subir os arquivos.

O que você vai precisar antes de começar

• Acesso ao cPanel da sua hospedagem (usuário e senha, disponíveis no seu painel.gehost.com.br ou enviados na entrega da hospedagem).
• Os arquivos da sua aplicação Node.js prontos (incluindo o arquivo package.json).
• Saber qual arquivo é o "ponto de entrada" da sua aplicação (geralmente algo como app.js, server.js ou index.js).

Passo 1 — Acesse o cPanel

1. Abra o link de acesso ao cPanel da sua hospedagem.
2. Digite seu usuário e senha e clique em Log in.

Passo 2 — Encontre o Node.js Selector

1. Já dentro do painel principal do cPanel, procure a seção Software.
2. Clique no ícone/link Setup Node.js App (também chamado de "Node.js Selector").

💡 Dica da Sensei: se você usa a caixa de busca no topo do cPanel, é só digitar "Node" que a ferramenta aparece na hora.

Passo 3 — Crie a aplicação

1. Clique no botão Create Application (Criar Aplicação).
2. Preencha os campos principais:
   • Node.js version: escolha a versão do Node que sua aplicação precisa (se não souber, use a mais recente disponível ou confirme com quem desenvolveu o projeto).
   • Application mode: normalmente Production.
   • Application root: a pasta dentro da sua hospedagem onde os arquivos da aplicação vão ficar (ex.: minhaapp).
   • Application URL: o domínio ou subdomínio pelo qual a aplicação será acessada.
   • Application startup file: o nome do arquivo principal da sua aplicação (ex.: app.js).
3. Clique em Create para salvar.

⚠️ Atenção: a Application root é só a "casinha" da sua aplicação. Ainda falta colocar os arquivos dentro dela — é o próximo passo.

Passo 4 — Envie os arquivos da sua aplicação

1. Acesse o Gerenciador de Arquivos do cPanel.
2. Entre na pasta que você definiu como Application root no passo anterior.
3. Faça o upload de todos os arquivos da sua aplicação (incluindo o package.json) ali dentro.

Se preferir, também é possível enviar os arquivos por FTP, usando o mesmo caminho de pasta.

Passo 5 — Instale as dependências

1. Volte para a tela do Setup Node.js App.
2. Encontre a aplicação que você criou na lista e clique nela para abrir os detalhes.
3. Clique no botão Run NPM Install. É esse botão que vai ler o seu package.json e instalar tudo que a aplicação precisa para funcionar.

Passo 6 — Inicie (ou reinicie) a aplicação

1. Ainda na tela de detalhes da aplicação, clique em Start App (ou Restart, se ela já estiver rodando e você quiser aplicar alguma mudança).
2. Confira se o status mostrado é de aplicação em execução.

Passo 7 — Teste no navegador

Abra o domínio ou subdomínio que você configurou como Application URL em uma nova aba do navegador e veja se sua aplicação está respondendo. Se aparecer a tela esperada, prontinho — está no ar! 🎉

Dicas úteis da Sensei

• Variáveis de ambiente: se sua aplicação usa variáveis do tipo .env, o próprio Node.js Selector tem um campo para cadastrar Environment Variables na tela de detalhes da aplicação — não é preciso subir um arquivo .env junto.
• Mudou algo no código? Depois de atualizar os arquivos pelo Gerenciador de Arquivos ou FTP, volte na aplicação e clique em Restart para as mudanças valerem.
• Deu erro ao iniciar? Revise se o campo Application startup file está com o nome certo do seu arquivo principal e se o package.json realmente está dentro da pasta configurada como Application root.

Ficou com dúvida em algum passo ou algo não funcionou como esperado? Sem problema — é só chamar o suporte da GeHost que a gente te ajuda a colocar sua aplicação Node no ar. 💙