Skip to main content

Menjalankan aplikasi Rails di VPS dengan systemd

Penulis

Anggit Wirasto, S.Si., M.Eng.

Dokumen ini merangkum menjalankan Rails di VPS Linux (Debian/Ubuntu) sebagai layanan systemd dengan Puma. Contoh di bawah disadur dari konfigurasi produksi; ganti user Linux, root aplikasi, nama unit, dan nama EnvironmentFile agar seragam di server Anda.

Prasyarat singkat

  • Aplikasi sudah di-deploy ke direktori tetap (contoh: /var/www/nama_app — ganti nama_app sesuai kebijakan deployment).
  • Ruby, Bundler, dan gem tersedia untuk user yang memiliki proses layanan (bukan root).
  • RAILS_ENV=production (dan secret lain) diatur lewat EnvironmentFile atau config yang konsisten.

1. Unit file systemd (contoh produksi)

Simpan unit misalnya di /etc/systemd/system/rails-app.service lalu isi (sesuaikan nama berkas, user, dan path):

[Unit]
Description=Puma HTTP server (aplikasi Rails, produksi)
After=network.target

[Service]
User=app
Group=app
WorkingDirectory=/var/www/nama_app

# --- PENTING UNTUK LOGGING ---
# Pastikan Rails TIDAK melempar log ke STDOUT, tapi ke file log/production.log
# (Hapus baris ini jika di production.rb Anda tidak ada logika RAILS_LOG_TO_STDOUT)
Environment=RAILS_LOG_TO_STDOUT=false
Environment=RAILS_SERVE_STATIC_FILES=true
EnvironmentFile=/etc/nama_app.env

# Simpan output Puma (startup info) dan error sistem ke file terpisah
StandardOutput=append:/var/www/nama_app/log/puma.access.log
StandardError=append:/var/www/nama_app/log/puma.error.log

ExecStart=/bin/bash -lc 'bundle exec puma -C /var/www/nama_app/config/puma.rb'
Restart=always
KillMode=process

[Install]
WantedBy=multi-user.target

Type=simple: tidak wajib ditulis; itu default untuk systemd versi baru — perilaku setara contoh lama “menjalankan satu proses”.

RAILS_LOG_TO_STDOUT=false: agar log aplikasi mengikuti log/production.log, bukan diserahkan ke journal lewat STDOUT. Sesuaikan dengan isi config/environments/production.rb: jika tidak ada guard RAILS_LOG_TO_STDOUT, baris Environment=... yang tidak relevan bisa dihapus.

RAILS_SERVE_STATIC_FILES=true: meminta Rails (Puma) melayani aset statis; umum bila tidak semua aset hanya lewat reverse proxy.

EnvironmentFile=/etc/nama_app.env: variabel tunggal per baris (KEY=nilai), sering memuat RAILS_ENV, database URL, secret key base, dsb. Berkas sebaiknya hanya dibaca root (chmod 600) dan isinya tidak di-commit.

StandardOutput / StandardError: stdout Puma (misalnya startup) dan stderr sistem dialihkan ke log/puma.access.log dan log/puma.error.log. pastikan direktori log/ ada dan dimiliki user yang sama dengan User=. Log request Rails yang “normal” tetap ke log/production.log selama RAILS_LOG_TO_STDOUT=false dan Puma/Rails memang menulis ke file.

ExecStart=... bash -lc '...': login shell memuat profile (misalnya rbenv/rvm/nvm), sehingga bundle dan Ruby terbaca walau PATH tidak di-hardcode di unit.

KillMode=process: sinyal berhenti mengarah ke proses utama; cocok bila worker Puma membutuhkan pola penghentian yang terkontrol. Bila butuh SIGTERM ke seluruh cgroup anak, tim lain memakai mixed (sesuaikan ke perilaku cluster Puma versi Anda).

WorkingDirectory: wajib mengarah ke root Rails agar relative path bundle exec dan asumsi Puma benar.

2. Berkas EnvironmentFile (ilustrasi)

Hanya contoh; jangan salin secret asli ke dokumentasi.

# /etc/nama_app.env
RAILS_ENV=production
# DATABASE_URL=...
# RAILS_MASTER_KEY=...  atau key lain yang dipakai app

Setelah mengubah .env atau unit: sudo systemctl daemon-reload bila perlu, lalu sudo systemctl restart rails-app.service.

3. Konfigurasi Puma (ringkas)

Di config/puma.rb pastikan bind selaras dengan Nginx: socket UNIX (unix://...) atau 127.0.0.1:port. Pastikan log/, tmp/pids/, tmp/sockets/ dapat ditulis user layanan.

4. Mengaktifkan dan mengelola layanan

sudo systemctl daemon-reload
sudo systemctl enable rails-app.service
sudo systemctl start rails-app.service
sudo systemctl status rails-app.service
  • Setelah deploy atau ganti gem: sudo systemctl restart rails-app.service
  • Cek journal bila perlu (pesan systemd / kegagalan start): sudo journalctl -u rails-app.service -e
  • Log startup Puma: log/puma.access.log dan log/puma.error.log; log aplikasi: log/production.log

5. Masalah yang sering muncul

  • Permission denied pada log/ atau socket: samakan pemilik direktori dengan User=.
  • bundle: command not found: perbaiki PATH (misalnya tetap memakai bash -lc) atau pasang wrapper penuh di ExecStart.
  • Dobel logging: jika RAILS_LOG_TO_STDOUT tidak false di runtime, isi journal + file bisa tumpang-tindih — konsistenkan dengan production.rb dan Environment=.

6. Nginx

Nginx meneruskan trafik ke bind Puma. Konfigurasi upstream / proxy_pass harus mengarah ke socket atau port yang sama dengan puma.rb.


Ringkasnya: user khusus (bukan root), WorkingDirectory, EnvironmentFile, variabel RAILS_*, StandardOutput/StandardError ke file Puma, dan bash -lc untuk bundle membentuk pola yang stabil di produksi. Samakan di seluruh baris: nama unit (.service), User/Group, root aplikasi, isi path di ExecStart dan di log, serta nama berkas di /etc/.