Se você tentou usar comandos como npm install ou npm run prod no terminal do cPanel e recebeu o erro "comando não encontrado", provavelmente o Node.js ainda não está ativado corretamente. Este guia mostra como resolver isso.
Neste tutorial, você vai aprender a configurar e ativar um ambiente Node.js no cPanel para executar seus comandos com sucesso.
Passo 1 – Acesse o cPanel
Entre no painel cPanel da sua hospedagem.
Procure pela opção chamada "Setup Node.js App" ou "Aplicativo Node.js".
Se essa opção não estiver visível, é necessário entrar em contato com sua hospedagem para verificar se o suporte a Node.js está disponível.
Passo 2 – Crie a aplicação Node.js
Dentro da seção "Setup Node.js App", clique em "Create Application".
Preencha os campos necessários:
Application mode: Production (ou Development, se estiver em fase de testes)
Node.js version: Escolha a versão que você precisa (ex: 18.x)
Application root: Diretório onde está sua aplicação (ex: loja)
Application startup file: Nome do arquivo principal da aplicação (ex: app.js)
Clique em "Create".
Passo 3 – Copie o comando de ativação
Após criar a aplicação, o cPanel vai gerar um comando semelhante a este:
source /home/seu-usuario/nodevenv/loja/18/bin/activate && cd /home/seu-usuario/loja
OBS: Substitua seu-usuario pelo usuário da sua conta de hospedagem.
Esse comando serve para ativar o ambiente Node.js no terminal.
Passo 4 – Abra o terminal do cPanel
Volte ao painel principal do cPanel e clique na opção "Terminal".
No terminal, cole e execute o comando gerado no passo 3. Isso vai ativar o Node.js e te posicionar na pasta do projeto.
Depois disso, você poderá executar:
npm install
npm run prod
Se quiser confirmar que o Node está ativo, rode:
node -v
Sempre ative o ambiente com o comando source antes de rodar comandos npm.
Verifique se o arquivo package.json está no diretório correto da aplicação.
O script "prod" precisa estar definido no package.json, dentro da seção "scripts".