Lokasi & Manajemen File Konfigurasi ServBay

ServBay adalah lingkungan pengembangan Web lokal yang tangguh, dengan inti manajemen konfigurasi yang fleksibel untuk berbagai paket perangkat lunak seperti server web, database, dan runtime bahasa. Untuk memudahkan pengelolaan serta menjaga stabilitas sistem, ServBay mengelola semua file konfigurasi di lokasi terpusat dengan struktur direktori yang jelas. Dokumen ini menguraikan lokasi penyimpanan file konfigurasi ServBay serta memberikan panduan bagaimana menemukan dan meninjau file-file penting tersebut.

Catatan Penting: Jangan melakukan edit manual pada file konfigurasi

File konfigurasi ServBay dihasilkan secara otomatis oleh aplikasi berdasarkan pengaturan yang Anda lakukan (melalui antarmuka UI). Jangan mengedit langsung file konfigurasi di direktori ServBay secara manual.

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Edit manual sangat berisiko ditimpa pada saat ServBay melakukan pembaruan, restart layanan, atau saat Anda melakukan perubahan melalui UI, sehingga modifikasi Anda bisa hilang atau menyebabkan error yang tidak terduga.

Selalu lakukan perubahan konfigurasi lewat antarmuka grafis ServBay (UI) atau tool baris perintah resmi untuk memastikan perubahan bersifat permanen dan sistem tetap stabil. Informasi jalur file di dokumen ini bertujuan untuk membantu memahami struktur internal ServBay atau membantu saat troubleshooting.

Ringkasan Struktur Direktori

File konfigurasi ServBay terpusat di beberapa direktori inti dan diklasifikasi berdasarkan nama serta versi paket perangkat lunak:

Direktori Konfigurasi Utama:

• macOS: /Applications/ServBay/etc
• Windows: C:\ServBay\etc

Inilah direktori utama ServBay yang berisi file konfigurasi server web (seperti Nginx, Caddy, Apache), runtime bahasa (seperti file php.ini PHP), database (seperti konfigurasi MySQL, MariaDB), serta layanan lain (Redis, Memcached).

Direktori Database:

• macOS: /Applications/ServBay/db
• Windows: C:\ServBay\db

Direktori ini menyimpan file data database, serta beberapa file konfigurasi khusus database seperti file kontrol akses PostgreSQL.

Direktori Paket Umum:

• macOS: /Applications/ServBay/package/common
• Windows: C:\ServBay\package\common

Berisi beberapa paket umum seperti OpenSSL; file konfigurasi untuk paket ini juga berada di sini.

Penjelasan Lokasi File Konfigurasi Paket

Berikut adalah beberapa contoh lokasi file konfigurasi untuk paket populer di ServBay:

Server Web (Web Servers)

File konfigurasi server web tersimpan dalam direktori utama ServBay—subdirektori berdasarkan nama server. ServBay mendukung beberapa versi sehingga konfigurasi dikelompokkan per versi.

• Nginx: Direktori utama konfigurasi:

  • macOS: /Applications/ServBay/etc/nginx
  • Windows: C:\ServBay\etc\nginx

  Contohnya, konfigurasi untuk Nginx versi 1.25:

  • macOS: /Applications/ServBay/etc/nginx/1.25/nginx.conf
  • Windows: C:\ServBay\etc\nginx\1.25\nginx.conf

  File konfigurasi lain (seperti konfigurasi situs, konfigurasi SSL) biasanya tersusun di bawah direktori ini atau subdirektorinya.

• Caddy: Direktori utama konfigurasi:

  • macOS: /Applications/ServBay/etc/caddy
  • Windows: C:\ServBay\etc\caddy

  File utama konfigurasi Caddy:

  • macOS: /Applications/ServBay/etc/caddy/Caddyfile
  • Windows: C:\ServBay\etc\caddy\Caddyfile

• Apache: Direktori utama konfigurasi:

  • macOS: /Applications/ServBay/etc/apache
  • Windows: C:\ServBay\etc\apache

  Contoh path konfigurasi untuk Apache versi 2.4:

  • macOS: /Applications/ServBay/etc/apache/2.4/httpd.conf
  • Windows: C:\ServBay\etc\apache\2.4\httpd.conf

  Konfigurasi virtual host dan lainnya biasanya terdapat di subdirektori extra.

Runtime Bahasa (Language Runtimes)

File konfigurasi runtime bahasa (PHP, Python, Node.js, Go, Java, dsb) umumnya juga terletak di direktori utama, terklasifikasi berdasarkan nama dan versi bahasa.

• PHP: Direktori utama konfigurasi:

  • macOS: /Applications/ServBay/etc/php
  • Windows: C:\ServBay\etc\php

  Contoh konfigurasi php.ini untuk PHP versi 8.2:

  • macOS: /Applications/ServBay/etc/php/8.2/php.ini
  • Windows: C:\ServBay\etc\php\8.2\php.ini

  Konfigurasi PHP-FPM biasanya berada di direktori versi yang sama.

• Python: Konfigurasi Python umumnya dikelola lewat environment variable atau file proyek; eksekusi Python yang disediakan ServBay terdapat di:

  • macOS: /Applications/ServBay/package/python/{version}/bin
  • Windows: C:\ServBay\package\python\{version}\bin

  Konfigurasi global Python jarang melalui direktori utama ServBay.

• Node.js, Go, Java, Ruby, Rust, .NET: Sama seperti Python, konfigurasi untuk bahasa ini lebih didasarkan pada pengaturan proyek, environment variable, atau toolchain masing-masing. ServBay terutama menyediakan runtime/SDK, bukan konfigurasi global terpusat.

Database (Databases)

File konfigurasi database tersebar antara direktori utama dan direktori data.

• MySQL / MariaDB: Direktori utama konfigurasi:

  • macOS: /Applications/ServBay/etc/mysql (atau /Applications/ServBay/etc/mariadb)
  • Windows: C:\ServBay\etc\mysql (atau C:\ServBay\etc\mariadb)

  Contoh konfigurasi untuk MySQL 8.0:

  • macOS: /Applications/ServBay/etc/mysql/8.0/my.cnf
  • Windows: C:\ServBay\etc\mysql\8.0\my.cnf

  File ini berisi pengaturan utama database.

• PostgreSQL: File konfigurasi utama PostgreSQL terletak di:

  • macOS: /Applications/ServBay/etc/postgresql
  • Windows: C:\ServBay\etc\postgresql

  Contoh untuk PostgreSQL versi 16:

  • macOS: /Applications/ServBay/etc/postgresql/16/postgresql.conf
  • Windows: C:\ServBay\etc\postgresql\16\postgresql.conf

  File untuk autentikasi client (pg_hba.conf dan pg_ident.conf) berada di direktori database, terklasifikasi per versi:

  • macOS: /Applications/ServBay/db/postgresql/16/pg_hba.conf
  • macOS: /Applications/ServBay/db/postgresql/16/pg_ident.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_hba.conf
  • Windows: C:\ServBay\db\postgresql\16\pg_ident.conf

• MongoDB, Redis: File konfigurasi untuk database ini biasanya tersimpan di direktori utama, per nama dan versi.

  • macOS: /Applications/ServBay/etc
  • Windows: C:\ServBay\etc

  Contoh konfigurasi Redis:

  • macOS: /Applications/ServBay/etc/redis/redis.conf
  • Windows: C:\ServBay\etc\redis\redis.conf

Layanan Lain dan Paket Umum

• OpenSSL: File konfigurasi OpenSSL berada di direktori paket umum, terklasifikasi per versi:

  • macOS: /Applications/ServBay/package/common/openssl
  • Windows: C:\ServBay\package\common\openssl

  Contoh untuk OpenSSL versi 3.2:

  • macOS: /Applications/ServBay/package/common/openssl/3.2/openssl.cnf
  • Windows: C:\ServBay\package\common\openssl\3.2\openssl.cnf

• ACME (untuk permohonan sertifikat SSL otomatis): Konfigurasi dan penyimpanan sertifikat ACME biasanya di:

  • macOS: /Applications/ServBay/etc/acme atau /Applications/ServBay/db/acme
  • Windows: C:\ServBay\etc\acme atau C:\ServBay\db\acme

Cara Menemukan dan Melihat Isi File Konfigurasi

Walaupun tidak dianjurkan mengedit manual, pengembang sering kali perlu memeriksa isi file konfigurasi guna memahami pengaturan aktif atau troubleshooting. Berikut langkah-langkahnya:

1. Navigasi ke direktori file konfigurasi: Gunakan terminal untuk masuk ke direktori yang sesuai.

   macOS (menggunakan Terminal, iTerm2, dll):

   # Tampilkan direktori konfigurasi Nginx
   cd /Applications/ServBay/etc/nginx/
   
   # Tampilkan direktori pg_hba.conf PostgreSQL 16
   cd /Applications/ServBay/db/postgresql/16

   Windows (menggunakan PowerShell atau Command Prompt):

   # Tampilkan direktori konfigurasi Nginx
   cd C:\ServBay\etc\nginx\
   
   # Tampilkan direktori pg_hba.conf PostgreSQL 16
   cd C:\ServBay\db\postgresql\16

2. Daftar file: Lihat daftar file di direktori:

   macOS:

   ls

   Windows:

   # PowerShell
   Get-ChildItem
   # atau singkatnya
   ls
   
   # Command Prompt
   dir

3. Lihat isi file: Gunakan editor/penampil teks (hanya untuk melihat, jangan simpan perubahan) untuk meninjau isi file.

   macOS:

   # Lihat nginx.conf Nginx
   cat nginx.conf
   # Atau pakai less untuk men-scroll
   less nginx.conf
   
   # Lihat php.ini PHP 8.2
   less /Applications/ServBay/etc/php/8.2/php.ini

   Windows:

   # PowerShell - Tampilkan nginx.conf Nginx
   Get-Content nginx.conf
   # Atau gunakan more untuk paging
   more nginx.conf
   
   # Tampilkan php.ini PHP 8.2
   Get-Content C:\ServBay\etc\php\8.2\php.ini | more
   
   # Command Prompt
   type nginx.conf
   more nginx.conf

4. Restart layanan (jika perubahan dilakukan lewat UI ServBay): Jika konfigurasi diubah lewat UI, biasanya perlu restart layanan agar perubahan efektif. Lakukan lewat panel manajemen ServBay atau gunakan servbayctl.

   macOS:

   # Restart layanan Nginx
   servbayctl restart nginx -all
   
   # Restart layanan PHP 8.2
   servbayctl restart php 8.2
   
   # Restart semua layanan
   servbayctl restart all

   Windows:

   # Restart layanan Nginx
   servbayctl.exe restart nginx -all
   
   # Restart layanan PHP 8.2
   servbayctl.exe restart php 8.2
   
   # Restart semua layanan
   servbayctl.exe restart all

FAQ (Pertanyaan Umum)

• Tanya: Bolehkah saya mengedit file konfigurasi manual untuk uji coba setting lanjutan?

  Jawab: Sangat tidak disarankan. UI ServBay sudah menyediakan banyak opsi pengaturan yang umum digunakan. Jika Anda butuh kustomisasi lanjutan yang tidak didukung UI, konsultasikan dokumentasi konfigurasi tingkat lanjut ServBay atau komunitas. File yang diedit manual sangat rentan ditimpa.

• Tanya: Bagaimana ServBay mengelola file konfigurasi multi-versi untuk paket perangkat lunak?

  Jawab: Seperti dijelaskan, ServBay membuat subdirektori tersendiri untuk setiap nama dan versi paket di dalam direktori utama konfigurasi (macOS: /Applications/ServBay/etc atau /Applications/ServBay/db; Windows: C:\ServBay\etc atau C:\ServBay\db), sehingga setiap versi terisolasi dan tidak saling mengganggu.

• Tanya: Apa yang harus saya lakukan kalau file konfigurasi terhapus atau rusak?

  Jawab: Karena ServBay secara otomatis menghasilkan file konfigurasi dari template dan pengaturan Anda, biasanya Anda bisa melakukan perubahan konfigurasi kecil lewat UI agar ServBay membuat ulang file konfigurasi. Bila masalah tetap ada, coba reset konfigurasi atau kontak support ServBay.

Kesimpulan

ServBay mengelola file konfigurasi paket perangkat lunak secara terpusat dan terstruktur, dengan pola direktori konsisten di semua sistem operasi:

• macOS: Utama di /Applications/ServBay/etc, didukung oleh /Applications/ServBay/db dan /Applications/ServBay/package/common
• Windows: Utama di C:\ServBay\etc, didukung oleh C:\ServBay\db dan C:\ServBay\package\common

Struktur ini memudahkan ServBay dalam mengelola file konfigurasi secara otomatis pada semua platform, serta memudahkan developer untuk pencarian dan troubleshooting.

Memahami lokasi file ini sangat bermanfaat untuk mengetahui cara kerja ServBay dan proses troubleshooting. Sekali lagi kami tekankan—lakukan perubahan konfigurasi hanya melalui UI atau tool resmi ServBay, jangan edit manual file, demi menjaga lingkungan ServBay tetap stabil dan terpercaya.