Jika Anda mengubah konfigurasi layanan Homebrew dan ingin perubahannya diterapkan, mulai ulang layanan tersebut menggunakan nama formula-nya: brew services restart formula. Misalnya, gunakan brew services restart postgresql@16 jika itu adalah formula yang Anda instal. Homebrew akan menghentikan layanan jika diperlukan, memulainya kembali, dan mendaftarkannya untuk berjalan saat login. Periksa daftar layanan setelahnya untuk mengonfirmasi status yang dilaporkan.

Sebelum memulai ulang, identifikasi layanan dan konfigurasinya

Layanan Homebrew mengelola proses latar belakang melalui launchctl macOS. Tanpa sudo, Homebrew beroperasi pada LaunchAgents milik pengguna saat ini, yang ditujukan untuk mulai berjalan saat login. Dengan sudo, Homebrew beroperasi pada LaunchDaemons sistem, yang ditujukan untuk mulai berjalan saat boot. Referensi brew services Homebrew mendokumentasikan perbedaan ini, jadi gunakan tingkat hak akses yang sama dengan yang awalnya memulai layanan; beralih antara konteks pengguna dan root dapat membuat Anda memeriksa atau memengaruhi pendaftaran layanan yang berbeda.

Jika Anda tidak yakin dengan nama formula-nya, buat daftar layanan yang dikelola Homebrew untuk pengguna Anda saat ini:

brew services list

Daftar tersebut dapat menampilkan nama layanan, status, pengguna, dan jalur plist. Gunakan nama formula yang ditampilkan di sana dalam perintah mulai ulang. Hindari --all kecuali Anda berniat memulai ulang setiap layanan yang dikelola, karena ini akan memengaruhi lebih dari sekadar layanan yang konfigurasinya Anda edit. Referensi ini juga mendokumentasikan brew services list --debug untuk keluaran Homebrew dan launchctl tambahan saat pemecahan masalah.

Terapkan perubahan dengan brew services restart

Jalankan perintah mulai ulang di Terminal menggunakan akun macOS yang sama dengan yang menjalankan layanan:

brew services restart postgresql@16

Ganti postgresql@16 dengan formula yang Anda temukan di daftar layanan. Nama berversi tersebut hanyalah contoh. Homebrew mendefinisikan restart sebagai tindakan menghentikan layanan jika perlu dan langsung memulainya, sekaligus mendaftarkannya untuk berjalan saat login (atau boot jika digunakan dengan sudo). Hal ini membuat restart cocok saat layanan yang sedang berjalan harus memuat ulang konfigurasi. Referensi perintah mencantumkan perilaku ini serta flag opsional --all dan --file.

Jangan menambahkan sudo secara otomatis. Gunakan hanya jika layanan tersebut sengaja didaftarkan sebagai layanan sistem dan Anda berniat mengelola pendaftaran tingkat root. Jika tidak, sudo mungkin menargetkan LaunchDaemon yang berbeda, dan layanan tingkat pengguna dapat tetap tidak terpengaruh. Jika Anda hanya ingin sebuah proses berjalan sekali tanpa mendaftarkannya untuk berjalan saat login, Homebrew mendokumentasikan brew services run formula; perintah tersebut tidak menggantikan restart untuk layanan yang Anda harapkan tetap dikelola.

Periksa hasilnya dan atasi masalah jika mulai ulang gagal

Setelah perintah selesai, periksa kembali daftar layanan yang dikelola:

brew services list

Pastikan formula yang dimaksud muncul dengan status started dan periksa pengguna serta jalur plist-nya. Status started mengonfirmasi bahwa Homebrew melaporkannya telah dimulai; hal ini tidak secara independen membuktikan bahwa aplikasi telah menerima pengaturan baru atau sedang merespons permintaan. Verifikasi aplikasi dengan pemeriksaan kesehatan (health check) terdokumentasi miliknya sendiri atau dengan memeriksa perilaku yang dikendalikan oleh pengaturan yang diubah.

Jika layanan tidak dapat dimulai, jalankan perintah list dengan --debug dan baca keluaran kesalahan atau log milik layanan itu sendiri sebelum membuat perubahan lebih lanjut. Periksa sintaksis konfigurasi aplikasi, izin file, dan jalur terhadap dokumentasi aplikasi tersebut. Perintah layanan Homebrew memulai layanan menggunakan definisi layanannya; perintah ini tidak memvalidasi setiap opsi konfigurasi khusus aplikasi. Hindari mengedit file plist yang dihasilkan sebagai perbaikan pertama: mekanisme konfigurasi terdokumentasi Homebrew bergantung pada pengaturan yang perlu Anda ubah.

Jika perubahannya adalah variabel lingkungan

Jika perubahan Anda berupa variabel lingkungan untuk layanan tersebut, Homebrew mendokumentasikan file lingkungan khusus per-formula. Secara default, letakkan di ~/.homebrew/services/formula.env; jika HOMEBREW_USER_CONFIG_HOME disetel, direktori tersebut adalah $HOMEBREW_USER_CONFIG_HOME/services. Gunakan satu penetapan KEY=value per baris, dengan # di awal baris komentar. Kemudian mulai ulang layanan; Homebrew menyatakan nilai-nilai ini akan berlaku pada mulai ulang berikutnya dan tetap ada setelah peningkatan versi (upgrade). Lihat instruksi lingkungan layanan di referensi Homebrew.

Sebagai contoh, format file yang terdokumentasi adalah KEY=value, tetapi nama variabel dan nilainya harus berasal dari dokumentasi aplikasi. Jangan berasumsi bahwa setiap aplikasi menerima variabel lingkungan arbitrer, dan jangan menempelkan informasi rahasia ke dalam file lingkungan tanpa mempertimbangkan siapa yang dapat membacanya. Jika perubahan konfigurasi Anda berupa file konfigurasi aplikasi alih-alih variabel lingkungan, edit lokasi file yang ditentukan oleh aplikasi tersebut, lalu gunakan perintah mulai ulang yang sama.

Urutan yang andal adalah: identifikasi formula dan konteks layanan yang tepat, edit pengaturan di lokasi yang ditentukan oleh aplikasi atau dokumentasi Homebrew, mulai ulang formula tersebut, dan verifikasi status Homebrew serta perilaku aplikasi.

Sumber