wils@web ~ $ cat ~/ajuda/como-criar-um-servico-systemd-para-um-aplicativo-node-js-no-ubuntu-22-04-passo-a-passo.md

Linux

Como criar um serviço systemd para um aplicativo Node.js no Ubuntu 22.04: Passo a passo

atualizado em 22/08/2026

Este manual tem como objetivo orientar você na criação de um serviço systemd para um aplicativo Node.js no Ubuntu 22.04. O uso do systemd permite gerenciar o seu aplicativo de forma eficiente, garantindo que ele inicie automaticamente na inicialização do sistema e seja monitorado.

Passo a Passo

1. Instalação do Node.js

  • Primeiro, atualize o sistema:
  • sudo apt update && sudo apt upgrade -y
  • Instale o Node.js:
  • sudo apt install nodejs npm -y

2. Criar seu aplicativo Node.js

  • Crie um diretório para seu aplicativo:
  • mkdir ~/meu_app && cd ~/meu_app
  • Crie um arquivo app.js com o seguinte conteúdo:
  • echo "const http = require('http');
    const hostname = '127.0.0.1';
    const port = 3000;
    
    const server = http.createServer((req, res) => {
      res.statusCode = 200;
      res.setHeader('Content-Type', 'text/plain');
      res.end('Hello World\n');
    });
    
    server.listen(port, hostname, () => {
      console.log(`Server running at http://${hostname}:${port}/`);
    });" > app.js

3. Testar o aplicativo

  • Execute o aplicativo para verificar se está funcionando:
  • node app.js
  • Acesse http://127.0.0.1:3000 em seu navegador.

4. Criar um serviço systemd

  • Crie um arquivo de serviço:
  • sudo nano /etc/systemd/system/meu_app.service
  • Adicione o seguinte conteúdo ao arquivo:
  • [Unit]
    Description=Meu App Node.js
    After=network.target
    
    [Service]
    ExecStart=/usr/bin/node /home/seu_usuario/meu_app/app.js
    Restart=always
    User=seu_usuario
    Environment=PATH=/usr/bin:/usr/local/bin
    Environment=NODE_ENV=production
    
    [Install]
    WantedBy=multi-user.target

5. Habilitar e iniciar o serviço

  • Recarregue o systemd:
  • sudo systemctl daemon-reload
  • Habilite o serviço para iniciar automaticamente:
  • sudo systemctl enable meu_app
  • Inicie o serviço:
  • sudo systemctl start meu_app

6. Verificar o status do serviço

  • Para verificar se o serviço está rodando:
  • sudo systemctl status meu_app

Conclusão

Agora você tem um serviço systemd configurado para seu aplicativo Node.js. Uma dica importante é sempre monitorar os logs do seu serviço para identificar possíveis problemas. Você pode visualizar os logs com:

journalctl -u meu_app

Precisa de ajuda com isso no seu servidor? A gente resolve pra você.

falar no WhatsApp

// deu erro ou não funcionou?

Achou algo errado neste manual?

Conta pra gente o que deu errado ou qual erro apareceu — a gente corrige. Se quiser retorno, deixe seu contato.