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

Linux

Como criar unidades de serviço systemd para aplicações personalizadas no Ubuntu 22.04

atualizado em 27/07/2026

O systemd é um sistema de inicialização e gerenciamento de serviços utilizado em diversas distribuições Linux, incluindo o Ubuntu 22.04. Neste manual, você aprenderá a criar unidades de serviço para suas aplicações personalizadas.

Introdução

As unidades de serviço do systemd permitem que você gerencie a execução de aplicações de forma eficiente, garantindo que elas sejam iniciadas, paradas e monitoradas corretamente.

Passo a Passo para Criar uma Unidade de Serviço

1. Criar o Arquivo de Unidade

Primeiro, crie um arquivo de unidade no diretório /etc/systemd/system/. O nome do arquivo deve terminar com .service. Por exemplo, para uma aplicação chamada minha-aplicacao, execute:

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

2. Definir as Propriedades da Unidade

Adicione as seguintes linhas ao arquivo:

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

[Service]
Type=simple
ExecStart=/usr/bin/minha-aplicacao
Restart=on-failure

[Install]
WantedBy=multi-user.target
  • Description: Descrição da sua aplicação.
  • After: Define a ordem de inicialização (neste caso, aguarda a rede).
  • ExecStart: Caminho para o executável da sua aplicação.
  • Restart: Define o comportamento de reinício em caso de falha.
  • WantedBy: Define o alvo de inicialização.

3. Salvar e Sair

Após editar, salve o arquivo e saia do editor (no nano, pressione CTRL + X, depois Y e ENTER).

4. Habilitar e Iniciar o Serviço

Para habilitar o serviço para iniciar automaticamente no boot, execute:

sudo systemctl enable minha-aplicacao.service

Para iniciar o serviço imediatamente, execute:

sudo systemctl start minha-aplicacao.service

5. Verificar o Status do Serviço

Para verificar se o serviço está rodando corretamente, use:

sudo systemctl status minha-aplicacao.service

Conclusão

Agora você sabe como criar e gerenciar unidades de serviço no Ubuntu 22.04. Lembre-se de testar seu serviço e monitorar logs usando o comando journalctl -u minha-aplicacao.service para depuração.

Dica: Sempre revise as permissões do executável e o ambiente em que sua aplicação será executada.

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.