TeknoTUT

Cara Membuat Service systemd di Linux untuk Aplikasi Sendiri

Panduan membuat service systemd di Linux: menulis unit file, autostart saat boot, restart otomatis, membaca log dengan journalctl, hingga hardening.

Ditulis oleh 13 menit bacaEnglish
Ilustrasi server Linux dengan roda gigi yang menjalankan service secara otomatis
Daftar Isi

Jika anda pernah menjalankan aplikasi di server Linux, tentu anda tidak asing dengan situasi ini: aplikasi dijalankan dari terminal, semuanya lancar, lalu begitu sesi SSH ditutup, aplikasinya ikut mati. Atau lebih parah lagi, server reboot tengah malam dan aplikasi anda tidak pernah menyala kembali sampai ada yang mengeluh.

Banyak orang mengakalinya dengan nohup, screen, atau tmux. Cara ini memang bisa dipakai untuk sementara, tetapi aplikasi tetap tidak menyala otomatis saat boot, tidak dihidupkan ulang ketika crash, dan log-nya berceceran entah di mana.

Padahal, hampir semua distro Linux modern sudah membawa solusinya sejak awal, yaitu systemd. Dengan satu file konfigurasi pendek, aplikasi anda bisa berjalan di latar belakang, menyala sendiri saat boot, dan otomatis dihidupkan ulang jika mati mendadak.

Dalam artikel kali ini, kita akan membahas tuntas cara membuat service systemd untuk aplikasi sendiri, mulai dari memahami isi unit file, mengaktifkan autostart, membaca log dengan journalctl, menguji restart otomatis, hingga menambahkan pengamanan dasar. Mari kita mulai!

Apa itu systemd?

systemd adalah init system dan pengelola layanan (service manager) yang dipakai oleh sebagian besar distro Linux saat ini, termasuk Ubuntu, Debian, Fedora, dan Arch Linux. Ia adalah proses pertama yang dijalankan kernel saat boot (PID 1), lalu bertugas menyalakan dan mengawasi semua layanan lain di sistem.

Setiap hal yang dikelola systemd disebut unit, dan setiap unit didefinisikan lewat sebuah file teks yang disebut unit file. Ada beberapa jenis unit, misalnya .service untuk layanan, .timer untuk tugas terjadwal, dan .socket untuk socket activation. Di artikel ini kita fokus pada jenis yang paling sering dipakai, yaitu .service.

Sebenarnya anda sudah sering berinteraksi dengan systemd. Setiap kali menjalankan sudo systemctl restart nginx atau systemctl status ssh, anda sedang berbicara dengan systemd. Nah, sekarang kita akan membuat aplikasi sendiri diperlakukan sama seperti Nginx atau SSH tersebut.

Mengapa Harus Memakai Service systemd?

Berikut beberapa keuntungan menjalankan aplikasi sebagai service systemd:

  • Menyala otomatis saat boot: cukup sekali enable, aplikasi ikut hidup setiap kali server menyala.
  • Restart otomatis saat crash: systemd mengawasi proses aplikasi dan menghidupkannya kembali sesuai aturan yang anda tentukan.
  • Log terpusat: semua yang ditulis aplikasi ke stdout dan stderr otomatis masuk ke journal dan bisa dibaca dengan journalctl.
  • Berjalan sebagai user terbatas: aplikasi tidak perlu berjalan sebagai root, cukup dengan satu baris User=.
  • Tanpa aplikasi tambahan: systemd sudah terpasang di server anda, tidak ada yang perlu di-install.
  • Fitur keamanan bawaan: systemd bisa membatasi akses aplikasi ke filesystem hanya dengan beberapa baris konfigurasi.

Lalu, bagaimana dengan process manager seperti PM2? Untuk aplikasi Node.js, PM2 menawarkan kemudahan seperti mode cluster dan reload tanpa downtime, seperti yang kami bahas di artikel cara deploy Next.js ke VPS dengan PM2 dan Nginx. Namun, systemd bersifat universal: bisa dipakai untuk aplikasi Python, Go, Rust, Java, script Bash, atau apa pun yang bisa dijalankan dari terminal.

Mengenal Struktur Unit File

Sebelum praktik, mari kita kenali dulu bentuk sebuah unit file. Isinya dibagi menjadi tiga bagian utama:

Bagian Fungsi Opsi yang sering dipakai
[Unit] Deskripsi dan hubungan dengan unit lain Description=, After=, Wants=
[Service] Cara menjalankan dan mengawasi aplikasi ExecStart=, User=, Restart=, Environment=
[Install] Kapan service dinyalakan saat boot WantedBy=

Unit file juga bisa berada di beberapa lokasi. Yang perlu anda ingat hanya dua:

  • /etc/systemd/system/: tempat unit buatan administrator. Di sinilah kita akan menyimpan service buatan sendiri.
  • /usr/lib/systemd/system/: tempat unit bawaan paket dari distro. File di sini jangan diubah langsung, karena akan tertimpa saat paket diperbarui.

Jika ada file dengan nama yang sama di kedua lokasi, file di /etc/systemd/system/ yang dipakai.

Persiapan

Sebelum memulai, pastikan anda sudah memiliki:

  • Server atau komputer dengan Ubuntu 24.04 LTS atau 26.04 LTS. Perintah di artikel ini ditujukan untuk kedua versi tersebut. Ubuntu 24.04 membawa systemd 255, dan semua opsi yang dipakai di sini sudah tersedia di versi itu. Distro lain yang memakai systemd (Debian, Fedora, Raspberry Pi OS) umumnya bisa mengikuti langkah yang sama.
  • Akses sudo. Jika server anda masih baru, sebaiknya ikuti dulu panduan cara mengamankan VPS Linux.
  • Python 3, yang sudah terpasang secara default di Ubuntu. Kita hanya memakainya untuk aplikasi contoh.

Anda bisa mengecek versi systemd yang terpasang dengan perintah berikut:

systemctl --version

Sebagai contoh, kita akan membuat aplikasi web kecil bernama halo-app. Tentu saja, anda bisa mengganti aplikasi contoh ini dengan aplikasi anda sendiri. Yang berubah nantinya hanya baris ExecStart= dan lokasi foldernya.

Cara Membuat Service systemd

Langkah #1: Siapkan Aplikasi Contoh

Pertama, buat folder untuk aplikasi di /opt:

sudo mkdir -p /opt/halo-app

Lalu buat file aplikasinya:

sudo nano /opt/halo-app/app.py

Isikan kode berikut. Aplikasi ini hanyalah server HTTP sederhana yang membalas setiap permintaan dengan sebuah pesan:

#!/usr/bin/env python3
import os
from http.server import BaseHTTPRequestHandler, HTTPServer
 
PORT = int(os.environ.get("PORT", "8000"))
PESAN = os.environ.get("PESAN", "Halo dari systemd!")
 
 
class Handler(BaseHTTPRequestHandler):
    def do_GET(self):
        self.send_response(200)
        self.send_header("Content-Type", "text/plain; charset=utf-8")
        self.end_headers()
        self.wfile.write((PESAN + "\n").encode())
 
 
if __name__ == "__main__":
    print(f"Server berjalan di port {PORT}", flush=True)
    HTTPServer(("127.0.0.1", PORT), Handler).serve_forever()

Simpan file dengan menekan Ctrl+X, lalu Y, dan Enter.

Perhatikan bahwa aplikasi membaca pengaturan PORT dan PESAN dari variabel environment. Nanti kita akan mengisinya lewat systemd.

Sebelum dijadikan service, pastikan dulu aplikasi bisa berjalan secara manual:

python3 /opt/halo-app/app.py

Jika muncul tulisan Server berjalan di port 8000, berarti aplikasinya normal. Hentikan dengan Ctrl+C.

Penting: selalu uji perintah secara manual sebelum menuliskannya ke unit file. Jika perintahnya saja gagal di terminal, systemd juga tidak akan bisa menjalankannya.

Langkah #2: Buat User Khusus untuk Service

Secara default, service systemd berjalan sebagai root. Ini berbahaya: jika aplikasi anda punya celah keamanan, penyerang langsung mendapatkan akses penuh ke server. Oleh karena itu, kita buat user sistem khusus yang tidak bisa login dan tidak punya folder home:

sudo useradd --system --no-create-home --shell /usr/sbin/nologin haloapp

File aplikasi di /opt/halo-app kita biarkan tetap dimiliki root. User haloapp cukup bisa membaca file tersebut, tidak perlu bisa mengubahnya. Dengan begitu, seandainya aplikasi berhasil dibobol, penyerang tidak bisa mengganti kode aplikasinya.

Langkah #3: Tulis Unit File

Sekarang kita masuk ke bagian intinya. Buat unit file baru dengan perintah berikut:

sudo nano /etc/systemd/system/halo-app.service

Isikan konfigurasi berikut:

[Unit]
Description=Halo App - contoh service systemd
After=network.target
 
[Service]
Type=exec
User=haloapp
WorkingDirectory=/opt/halo-app
ExecStart=/usr/bin/python3 /opt/halo-app/app.py
Environment=PORT=8000
Restart=on-failure
RestartSec=5
 
[Install]
WantedBy=multi-user.target

Penjelasan setiap barisnya:

  • Description: keterangan singkat yang tampil di systemctl status dan log.
  • After=network.target: service dijalankan setelah jaringan dasar siap. Opsi ini hanya mengatur urutan, bukan ketergantungan.
  • Type=exec: systemd menganggap service sudah berjalan setelah binary aplikasinya benar-benar berhasil dieksekusi. Dokumentasi systemd menyarankan tipe ini untuk layanan yang berjalan terus-menerus, karena kesalahan seperti file program yang tidak ada atau user yang salah langsung terdeteksi saat start. Pada tipe default (simple), systemctl start bisa melaporkan sukses meskipun programnya gagal dijalankan.
  • User: user yang menjalankan aplikasi.
  • WorkingDirectory: folder kerja aplikasi.
  • ExecStart: perintah untuk menjalankan aplikasi. Biasakan menulis path lengkap ke program (/usr/bin/python3, bukan python3). Anda bisa mencari path sebuah program dengan which python3.
  • Environment: mengisi variabel environment untuk aplikasi.
  • Restart=on-failure: aplikasi dihidupkan ulang jika berhenti secara tidak wajar (exit code bukan nol, mati karena sinyal, atau timeout). Jika dihentikan dengan systemctl stop, aplikasi tidak dihidupkan ulang.
  • RestartSec=5: jeda 5 detik sebelum dihidupkan ulang. Nilai default-nya hanya 100 milidetik, terlalu cepat untuk aplikasi yang crash karena database belum siap, misalnya.
  • WantedBy=multi-user.target: saat di-enable, service ikut dinyalakan pada proses boot normal.

Catatan: ExecStart= bukan shell. Tanda pipa (|), redirect (>), dan && tidak dikenali di sana. Jika anda benar-benar membutuhkannya, bungkus perintahnya dengan shell, misalnya ExecStart=/bin/sh -c 'perintah-a | perintah-b', atau lebih baik lagi, tulis sebagai file script tersendiri.

Sebelum melanjutkan, periksa dulu apakah ada kesalahan penulisan di unit file dengan perintah berikut:

sudo systemd-analyze verify /etc/systemd/system/halo-app.service

Jika tidak muncul pesan apa pun tentang halo-app.service, berarti penulisannya sudah benar.

Langkah #4: Aktifkan dan Jalankan Service

Setiap kali membuat atau mengubah unit file, systemd harus diminta membaca ulang konfigurasinya:

sudo systemctl daemon-reload

Selanjutnya, aktifkan autostart sekaligus jalankan service-nya sekarang juga:

sudo systemctl enable --now halo-app

Outputnya kira-kira seperti ini:

Created symlink /etc/systemd/system/multi-user.target.wants/halo-app.service → /etc/systemd/system/halo-app.service.

Perlu dipahami bahwa enable dan start adalah dua hal yang berbeda. start menjalankan service sekarang, sedangkan enable membuat service menyala saat boot. Opsi --now menggabungkan keduanya dalam satu perintah.

Langkah #5: Periksa Status dan Log

Cek apakah service sudah berjalan dengan perintah berikut:

systemctl status halo-app

Outputnya kira-kira seperti di bawah ini:

● halo-app.service - Halo App - contoh service systemd
     Loaded: loaded (/etc/systemd/system/halo-app.service; enabled; preset: enabled)
     Active: active (running) since Sun 2026-11-15 10:00:00 WIB; 8s ago
   Main PID: 1234 (python3)
      Tasks: 1 (limit: 2271)
     Memory: 9.1M
        CPU: 60ms
     CGroup: /system.slice/halo-app.service
             └─1234 /usr/bin/python3 /opt/halo-app/app.py
 
Nov 15 10:00:00 server systemd[1]: Started halo-app.service - Halo App - contoh service systemd.
Nov 15 10:00:00 server python3[1234]: Server berjalan di port 8000

Ada dua hal yang perlu diperhatikan. Tulisan enabled pada baris Loaded berarti autostart sudah aktif, dan active (running) pada baris Active berarti aplikasi sedang berjalan. Tekan q untuk keluar dari tampilan status.

Sekarang coba akses aplikasinya:

curl http://127.0.0.1:8000

Jika outputnya Halo dari systemd!, selamat, service pertama anda sudah berjalan!

Untuk melihat log aplikasi, gunakan journalctl dengan opsi -u (unit):

journalctl -u halo-app -n 50

Opsi -n 50 menampilkan 50 baris terakhir. Untuk memantau log secara langsung (seperti tail -f), gunakan opsi -f:

journalctl -u halo-app -f

Anda tidak perlu mengatur file log apa pun. Semua yang ditulis aplikasi ke stdout dan stderr otomatis ditangkap oleh journal, lengkap dengan waktu dan nama prosesnya.

Tips untuk Python: jika output print() tidak langsung muncul di journalctl, penyebabnya adalah buffer output Python. Tambahkan flush=True seperti pada contoh di atas, atau tambahkan baris Environment=PYTHONUNBUFFERED=1 di unit file.

Langkah #6: Uji Restart Otomatis

Sekarang pertanyaannya: apakah aplikasi benar-benar dihidupkan ulang saat crash? Mari kita buktikan dengan "membunuh" prosesnya secara paksa:

sudo systemctl kill -s SIGKILL halo-app

Langsung cek statusnya:

systemctl status halo-app

Pada baris Active, anda akan melihat kira-kira seperti ini:

     Active: activating (auto-restart) (Result: signal) since Sun 2026-11-15 10:05:00 WIB; 2s ago

Tunggu 5 detik (sesuai RestartSec=5), lalu cek kembali. Statusnya akan kembali menjadi active (running) dengan Main PID yang baru. Keren kan?

Berikut pilihan nilai Restart= yang paling sering dipakai:

Nilai Kapan aplikasi dihidupkan ulang Cocok untuk
no (default) Tidak pernah Script sekali jalan
on-failure Saat berhenti secara tidak wajar Sebagian besar aplikasi server (disarankan)
always Selalu, kecuali dihentikan lewat systemctl stop Aplikasi yang tidak boleh berhenti sama sekali

Perlu diketahui: systemd punya pembatas agar service yang terus-menerus gagal tidak dihidupkan ulang tanpa henti. Secara default batasnya adalah 5 kali start dalam 10 detik. Jika terlampaui, service ditandai gagal dengan keterangan start-limit-hit dan tidak dicoba lagi. Dengan RestartSec=5, batas ini tidak akan pernah tercapai, sehingga systemd akan terus mencoba setiap 5 detik. Untuk mengubah batasnya, gunakan StartLimitIntervalSec= dan StartLimitBurst= di bagian [Unit].

Langkah #7: Simpan Konfigurasi di File Environment

Menulis Environment= langsung di unit file tidak masalah untuk satu atau dua variabel. Namun, untuk konfigurasi yang banyak atau bersifat rahasia (password database, API key), lebih baik pisahkan ke file tersendiri.

Buat file environment dengan perintah berikut:

sudo nano /etc/halo-app.env

Isikan variabel dengan format NAMA=nilai, satu per baris:

PORT=8000
PESAN=Halo, ini pesan dari file environment!

Karena file ini bisa berisi data rahasia, batasi agar hanya root yang bisa membacanya. systemd membaca file ini sebelum menjalankan aplikasi, jadi user haloapp tidak perlu punya akses ke sana:

sudo chmod 600 /etc/halo-app.env

Selanjutnya buka kembali unit file-nya:

sudo nano /etc/systemd/system/halo-app.service

Ganti baris Environment=PORT=8000 dengan baris berikut:

EnvironmentFile=/etc/halo-app.env

Muat ulang konfigurasi systemd, lalu restart service agar perubahan diterapkan:

sudo systemctl daemon-reload
sudo systemctl restart halo-app

Uji kembali dengan curl:

curl http://127.0.0.1:8000

Jika outputnya sudah berubah menjadi Halo, ini pesan dari file environment!, berarti file environment sudah terbaca.

Langkah #8: Tambahkan Pengamanan Dasar

Menarik bukan? Tetapi kita belum selesai. systemd memiliki fitur sandboxing yang bisa membatasi apa saja yang boleh disentuh oleh aplikasi. Fitur ini sangat berguna: seandainya aplikasi anda dibobol, kerusakan yang bisa ditimbulkan penyerang menjadi jauh lebih kecil.

Buka kembali unit file, lalu tambahkan baris berikut di bagian [Service]:

NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true

Penjelasan singkatnya:

  • NoNewPrivileges=true: proses aplikasi dan semua proses turunannya tidak bisa memperoleh hak akses tambahan, misalnya lewat sudo atau program setuid.
  • PrivateTmp=true: aplikasi mendapatkan folder /tmp pribadi yang terpisah dari aplikasi lain.
  • ProtectSystem=strict: hampir seluruh filesystem menjadi hanya-baca bagi aplikasi.
  • ProtectHome=true: folder /home, /root, dan /run/user tidak bisa diakses sama sekali.

Terapkan perubahan dengan perintah berikut:

sudo systemctl daemon-reload
sudo systemctl restart halo-app

Lalu pastikan service masih berjalan normal dengan systemctl status halo-app dan curl http://127.0.0.1:8000.

Hati-hati: opsi sandboxing bisa membuat aplikasi gagal berjalan jika aplikasi memang membutuhkan akses yang ditutup. Jika aplikasi anda berada di dalam /home, jangan pakai ProtectHome=true. Jika aplikasi perlu menulis file (database SQLite, file upload), tambahkan StateDirectory=halo-app. systemd akan membuatkan folder /var/lib/halo-app yang bisa ditulis oleh user service. Alternatifnya, buka folder tertentu dengan ReadWritePaths=/path/ke/folder. Tambahkan opsi satu per satu dan uji setiap kali.

systemd juga menyediakan alat untuk menilai seberapa "terbuka" sebuah service:

systemd-analyze security halo-app

Perintah ini menampilkan daftar panjang opsi pengamanan beserta skor paparan dari 0 (paling aman) sampai 10 (paling terbuka). Tidak perlu mengejar skor sempurna. Jadikan daftar tersebut sebagai referensi opsi apa lagi yang bisa anda tambahkan.

Perintah systemctl dan journalctl yang Sering Dipakai

Berikut ringkasan perintah untuk mengelola service sehari-hari:

Perintah Fungsi
sudo systemctl start halo-app Menjalankan service
sudo systemctl stop halo-app Menghentikan service
sudo systemctl restart halo-app Menghentikan lalu menjalankan kembali
sudo systemctl enable halo-app Mengaktifkan autostart saat boot
sudo systemctl disable halo-app Mematikan autostart
systemctl status halo-app Melihat status dan log terakhir
systemctl is-enabled halo-app Mengecek apakah autostart aktif
systemctl cat halo-app Menampilkan isi unit file yang sedang dipakai
sudo systemctl daemon-reload Membaca ulang unit file setelah diubah
journalctl -u halo-app -f Memantau log secara langsung
journalctl -u halo-app --since "1 hour ago" Log satu jam terakhir
journalctl -u halo-app -b Log sejak boot terakhir

Mengatasi Masalah yang Sering Terjadi

Jika service gagal berjalan, selalu mulai dari dua perintah ini: systemctl status halo-app dan journalctl -u halo-app -n 50. Berikut beberapa pesan yang paling sering muncul:

Gejala Penyebab Solusi
status=203/EXEC Program di ExecStart= tidak bisa dieksekusi Periksa path, izin eksekusi (chmod +x), dan baris shebang script
status=217/USER User di User= tidak ada Periksa nama user, atau buat user-nya (Langkah #2)
status=200/CHDIR Folder WorkingDirectory= tidak ada atau tidak bisa diakses Periksa path dan izin folder, juga opsi ProtectHome=
start-limit-hit Service gagal berulang kali dalam waktu singkat Perbaiki penyebabnya, lalu jalankan sudo systemctl reset-failed halo-app
Peringatan changed on disk Unit file diubah tetapi belum dimuat ulang Jalankan sudo systemctl daemon-reload
Perubahan tidak berpengaruh Service belum di-restart Jalankan sudo systemctl restart halo-app

Satu lagi hal yang sering membingungkan: jika aplikasi anda harus terhubung ke internet atau ke server lain tepat saat mulai berjalan, After=network.target belum tentu cukup. Gunakan pasangan berikut di bagian [Unit] agar service menunggu sampai jaringan benar-benar terhubung:

After=network-online.target
Wants=network-online.target

Bagaimana dengan Service Bawaan Paket?

Cara di atas berlaku untuk service buatan sendiri. Untuk service yang dipasang oleh paket (misalnya Nginx, Docker, atau Ollama), jangan mengubah unit file aslinya. Gunakan perintah berikut:

sudo systemctl edit nginx

Perintah ini membuat file drop-in di /etc/systemd/system/nginx.service.d/override.conf. Isinya digabungkan dengan unit file asli, sehingga pengaturan anda tidak hilang saat paket diperbarui. Contoh nyata pemakaiannya bisa anda lihat di artikel cara install Ollama di Ubuntu, saat kita mengatur variabel environment untuk layanan Ollama.

Kesimpulan

Dari artikel ini, kita dapat menyimpulkan bahwa membuat service systemd ternyata tidak rumit. Cukup dengan satu unit file berisi belasan baris di /etc/systemd/system/, aplikasi anda sudah berjalan di latar belakang, menyala otomatis saat boot, dihidupkan ulang saat crash, dan log-nya tercatat rapi di journal.

Yang Perlu Diingat

  • Simpan unit file buatan sendiri di /etc/systemd/system/, dan jalankan daemon-reload setiap kali mengubahnya.
  • enable untuk autostart saat boot, start untuk menjalankan sekarang. Gabungkan dengan enable --now.
  • Pakai Type=exec, Restart=on-failure, dan RestartSec= untuk aplikasi yang berjalan terus-menerus.
  • Jangan jalankan aplikasi sebagai root. Buat user khusus dan tambahkan opsi sandboxing secukupnya.
  • Saat ada masalah, systemctl status dan journalctl -u adalah teman terbaik anda.

Langkah Selanjutnya

Setelah menguasai .service, anda bisa melanjutkan dengan mempelajari systemd timer sebagai pengganti cron untuk tugas terjadwal, atau memasang reverse proxy seperti Nginx di depan aplikasi agar bisa diakses lewat domain dan HTTPS.


Jika ada pertanyaan atau anda menemui kendala saat mencoba, jangan ragu untuk bertanya. Tetap pantau terus web Teknotut!

Semoga artikel ini membantu.

Bacaan Selanjutnya

Artikel lain yang mungkin menarik buatmu.