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 --versionSebagai 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-appLalu buat file aplikasinya:
sudo nano /opt/halo-app/app.pyIsikan 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.pyJika 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 haloappFile 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.serviceIsikan 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.targetPenjelasan setiap barisnya:
- Description: keterangan singkat yang tampil di
systemctl statusdan 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 startbisa 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, bukanpython3). Anda bisa mencari path sebuah program denganwhich 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, misalnyaExecStart=/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.serviceJika 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-reloadSelanjutnya, aktifkan autostart sekaligus jalankan service-nya sekarang juga:
sudo systemctl enable --now halo-appOutputnya 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-appOutputnya 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 8000Ada 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:8000Jika 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 50Opsi -n 50 menampilkan 50 baris terakhir. Untuk memantau log secara langsung (seperti tail -f), gunakan opsi -f:
journalctl -u halo-app -fAnda 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 dijournalctl, penyebabnya adalah buffer output Python. Tambahkanflush=Trueseperti pada contoh di atas, atau tambahkan barisEnvironment=PYTHONUNBUFFERED=1di 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-appLangsung cek statusnya:
systemctl status halo-appPada 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 agoTunggu 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-hitdan tidak dicoba lagi. DenganRestartSec=5, batas ini tidak akan pernah tercapai, sehingga systemd akan terus mencoba setiap 5 detik. Untuk mengubah batasnya, gunakanStartLimitIntervalSec=danStartLimitBurst=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.envIsikan 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.envSelanjutnya buka kembali unit file-nya:
sudo nano /etc/systemd/system/halo-app.serviceGanti baris Environment=PORT=8000 dengan baris berikut:
EnvironmentFile=/etc/halo-app.envMuat ulang konfigurasi systemd, lalu restart service agar perubahan diterapkan:
sudo systemctl daemon-reload
sudo systemctl restart halo-appUji kembali dengan curl:
curl http://127.0.0.1:8000Jika 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=truePenjelasan singkatnya:
- NoNewPrivileges=true: proses aplikasi dan semua proses turunannya tidak bisa memperoleh hak akses tambahan, misalnya lewat
sudoatau program setuid. - PrivateTmp=true: aplikasi mendapatkan folder
/tmppribadi yang terpisah dari aplikasi lain. - ProtectSystem=strict: hampir seluruh filesystem menjadi hanya-baca bagi aplikasi.
- ProtectHome=true: folder
/home,/root, dan/run/usertidak bisa diakses sama sekali.
Terapkan perubahan dengan perintah berikut:
sudo systemctl daemon-reload
sudo systemctl restart halo-appLalu 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 pakaiProtectHome=true. Jika aplikasi perlu menulis file (database SQLite, file upload), tambahkanStateDirectory=halo-app. systemd akan membuatkan folder/var/lib/halo-appyang bisa ditulis oleh user service. Alternatifnya, buka folder tertentu denganReadWritePaths=/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-appPerintah 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.targetBagaimana 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 nginxPerintah 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 jalankandaemon-reloadsetiap kali mengubahnya. enableuntuk autostart saat boot,startuntuk menjalankan sekarang. Gabungkan denganenable --now.- Pakai
Type=exec,Restart=on-failure, danRestartSec=untuk aplikasi yang berjalan terus-menerus. - Jangan jalankan aplikasi sebagai root. Buat user khusus dan tambahkan opsi sandboxing secukupnya.
- Saat ada masalah,
systemctl statusdanjournalctl -uadalah 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.
Resources dan Link Berguna
- Dokumentasi systemd.service: semua opsi di bagian
[Service]. - Dokumentasi systemd.unit: opsi di bagian
[Unit]dan[Install], serta lokasi unit file. - Dokumentasi systemd.exec: opsi environment, user, dan sandboxing.
- Dokumentasi journalctl: semua opsi untuk membaca log.
Jika ada pertanyaan atau anda menemui kendala saat mencoba, jangan ragu untuk bertanya. Tetap pantau terus web Teknotut!
Semoga artikel ini membantu.



