wils@web ~ $ cat ~/ajuda/como-criar-unidades-de-servico-com-systemd-para-aplicacoes-em-node-js-no-ubuntu-22-04.md

Linux

Como criar unidades de serviço com systemd para aplicações em Node.js no Ubuntu 22.04

atualizado em 29/08/2026

Este manual fornece um guia passo a passo sobre como criar unidades de serviço com systemd para aplicações em Node.js no Ubuntu 22.04.

Introdução

O systemd é um sistema de inicialização e gerenciamento de serviços que permite gerenciar aplicações de forma eficiente. Criar uma unidade de serviço para sua aplicação Node.js garante que ela inicie automaticamente no boot e seja gerenciada adequadamente.

Passo a Passo

1. Instalar o Node.js

Primeiro, você precisa ter o Node.js instalado. Você pode instalar usando o NodeSource:

curl -fsSL https://deb.nodesource.com/setup_16.x | sudo -E bash -
sudo apt-get install -y nodejs

2. Criar sua aplicação Node.js

Crie um diretório para sua aplicação e um arquivo de exemplo:

mkdir ~/minha-aplicacao
cd ~/minha-aplicacao
npm init -y
npm install express
echo "const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;
app.get('/', (req, res) => res.send('Hello World!'));
app.listen(PORT, () => console.log('Servidor rodando na porta ' + PORT));" > index.js

3. Criar a unidade de serviço

Crie um arquivo de unidade de serviço no diretório /etc/systemd/system/:

sudo nano /etc/systemd/system/minha-aplicacao.service

Adicione o seguinte conteúdo ao arquivo:

[Unit]
Description=Minha Aplicação Node.js
After=network.target

[Service]
ExecStart=/usr/bin/node /home/SEU_USUARIO/minha-aplicacao/index.js
Restart=always
User=SEU_USUARIO
Environment=PATH=/usr/bin:/usr/local/bin
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target

4. Habilitar e iniciar o serviço

Habilite o serviço para iniciar no boot e inicie-o:

sudo systemctl enable minha-aplicacao
sudo systemctl start minha-aplicacao

5. Verificar o status do serviço

Você pode verificar se o serviço está rodando corretamente com o comando:

sudo systemctl status minha-aplicacao

Conclusão

Com esses passos, você configurou com sucesso uma unidade de serviço para sua aplicação Node.js. Isso garante que sua aplicação seja gerenciada de forma eficiente pelo systemd. Dica: Sempre verifique os logs de erro com journalctl -u minha-aplicacao caso enfrente problemas.

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.