Como configurar um ambiente Node.js na hospedagem GeHost
Olá, querido(a) desenvolvedor(a)! Seja bem-vindo(a) ao seu novo espaço de criação na GeHost. Você já sabe que o Node.js é uma das ferramentas mais poderosas para rodar aplicações web modernas, e aqui, na GeHost, você pode configurar seu ambiente Node.js com facilidade — mesmo que seja sua primeira vez. Vamos juntos, passo a passo, montar esse ambiente com carinho e clareza. 💡
Passo 1: Acesse o cPanel
Primeiro, faça login no seu painel de controle. Isso é como a porta de entrada do seu mundo digital na GeHost.
Passo 2: Encontre a ferramenta "Node.js" no cPanel
Após entrar no cPanel, procure pela seção “Software” ou “Aplicações”. Lá, você encontrará uma ferramenta chamada “Node.js”. Clique nela.
Se não aparecer imediatamente, use a barra de busca no cPanel (no canto superior direito) e digite “Node.js” — ele aparecerá rapidinho!
Passo 3: Crie um novo ambiente Node.js
Na tela do Node.js, clique no botão “Criar Ambiente” ou “Novo Ambiente”. Você verá um formulário com campos importantes:
- Nome do Ambiente: escolha um nome que lembre sua aplicação (ex: minha-app-node).
- Versão do Node.js: selecione a versão mais estável disponível (ex: 18.x ou 20.x). A GeHost sempre mantém versões atualizadas.
- Pasta de Aplicação: escolha uma pasta dentro de
public_html(ou crie uma nova, comoapp).
Depois de preencher, clique em “Criar”.
Passo 4: Faça upload da sua aplicação
Com o ambiente criado, agora é hora de colocar seu código no ar. Use o Gerenciador de Arquivos para enviar seus arquivos.
- Clique em “Gerenciador de Arquivos” no cPanel.
- Selecione a pasta onde você criou o ambiente (ex:
public_html/app). - Use o botão “Upload” para enviar todos os arquivos da sua aplicação (app.js, package.json, etc.).
Passo 5: Instale as dependências
Seu projeto provavelmente tem um arquivo chamado package.json. Esse arquivo diz ao Node.js quais pacotes ele precisa para funcionar.
Para instalar essas dependências:
- Volte ao cPanel e vá até a ferramenta “Node.js”.
- Na lista de ambientes, clique em “Gerenciar” ao lado do seu ambiente.
- Na nova tela, clique em “Instalar Dependências” (ou “Install Dependencies”).
Pronto! O sistema vai ler o package.json e instalar tudo automaticamente.
Passo 6: Configure o script de início (start)
Para que seu aplicativo inicie automaticamente, é essencial que o arquivo package.json tenha um script chamado start definido.
Exemplo de como deve estar seu package.json:
"scripts": {
"start": "node app.js"
}
Se esse script não existir, o ambiente não saberá qual arquivo executar. Adicione-o e salve.
Passo 7: Inicie seu aplicativo
Volte à tela de gerenciamento do ambiente Node.js e clique em “Iniciar”.
Se tudo estiver certo, você verá uma mensagem dizendo que o aplicativo está rodando. Agora, basta acessar seu domínio (ou subdomínio) com a porta correta — geralmente, o sistema já configura isso automaticamente.
Dica do Sensei 🌿
Se seu aplicativo não estiver rodando, verifique:
- Se o arquivo
app.jsou o nome do script principal está correto. - Se o
package.jsontem o scriptstartdefinido. - Se não há erros de sintaxe no código (como um ponto e vírgula faltando).
Erros são parte do aprendizado. Não se preocupe — cada bug é uma oportunidade de crescer. 💪
Parabéns! 🎉
Você acabou de configurar um ambiente Node.js na GeHost com sucesso! Agora, sua aplicação está no ar, pronta para receber visitantes e transformar ideias em realidade.
Se precisar de ajuda com logs, ajustes ou depuração, estamos aqui. É só chamar — você não está sozinho(a) nessa jornada.
Com carinho,
Seu Sensei da GeHost
