ServBay 設定ファイルの保存場所と管理

ServBayは強力なローカルWeb開発環境として、Webサーバー・データベース・言語ランタイムなど各種ソフトウェアパッケージの柔軟な設定管理を中核としています。管理と環境の安定性維持のため、ServBayでは全てのソフトウェアの設定ファイルを一元的に整理し、明確なディレクトリ構成で保管しています。本記事ではServBayの設定ファイル保存場所を詳述し、開発者がこれらの重要ファイルをどのように探し・確認するかを解説します。

重要：設定ファイルの直接編集はしないでください

ServBay の設定ファイルは、アプリケーションがあなたの設定（UI画面経由）に基づき自動生成します。/Applications/ServBay/etc やその他ServBayディレクトリ内の設定ファイルを直接編集しないでください。

手動で編集した内容は、ServBayアップデートやサービス再起動、またはUI経由での設定変更時に上書きされやすく、変更が失われたり予期しないエラーの原因となります。

全ての設定変更は、ServBay提供のグラフィカルユーザーインターフェース (UI) または公式推奨CLIツールから行いましょう。これにより変更内容が確実に反映され、システムの安定性も維持されます。本記事は主に内部構造の理解やトラブルシューティング時にファイルの場所を知るための情報を提供しています。

ディレクトリ構成の概要

ServBayの設定ファイルは以下の主要ディレクトリに集約されており、各ソフトウェアごと・バージョンごとに整理されています：

/Applications/ServBay/etc：ServBayの最重要設定ファイルディレクトリです。ほとんどのWebサーバー（Nginx、Caddy、Apache）、言語ランタイム（PHPのphp.iniなど）、データベース（MySQLやMariaDBの設定など）、その他のサービス（Redis、Memcached 等）もここに格納されています。
/Applications/ServBay/db：主にデータベース関連のデータファイルが保存されますが、一部データベース特有の設定ファイル（例：PostgreSQLの認証設定など）も含まれます。
/Applications/ServBay/package/common：OpenSSLなど汎用パッケージの設定ファイルディレクトリです。

ソフトウェア別設定ファイル保存場所

ここではServBayでよく利用される主なソフトウェアパッケージの設定ファイル保存先例を挙げます。

Webサーバー

Webサーバーの設定ファイルは通常 /Applications/ServBay/etc 以下に、各サーバー名が付いたサブディレクトリ内に保存されています。ServBayは複数バージョンの共存もサポートしているため、さらにバージョン別に分かれています。

Nginx: 設定ファイルの主パス：/Applications/ServBay/etc/nginx たとえばNginx 1.25の場合の設定ファイルパス例：
```
/Applications/ServBay/etc/nginx/1.25/nginx.conf
```
1
サイト設定ファイルやSSL関連の設定もこの直下またはサブディレクトリにまとめられています。
Caddy: 設定ファイルの主パス：/Applications/ServBay/etc/caddy Caddyの設定ファイル：
```
/Applications/ServBay/etc/caddy/Caddyfile
```
1
Apache: 設定ファイルの主パス：/Applications/ServBay/etc/apache たとえばApache 2.4の場合の設定ファイルパス例：
```
/Applications/ServBay/etc/apache/2.4/httpd.conf
```
1
バーチャルホストなどの細かい設定はextraディレクトリ内に整理されています。

言語ランタイム

PHP・Python・Node.js・Go・Javaなど各種言語ランタイムの設定も基本的に /Applications/ServBay/etc 以下、言語ごと・バージョンごとの構成になっています。

PHP: 設定ファイルの主パス：/Applications/ServBay/etc/php 例：PHP 8.2のphp.iniパス
```
/Applications/ServBay/etc/php/8.2/php.ini
```
1
PHP-FPMの設定ファイルも同じバージョン配下にあります。
Python: Pythonは環境変数やプロジェクト内ファイルで設定されることが多く、ServBay付属のPython環境では主実行ファイルが /Applications/ServBay/package/python/{version}/bin にあります。グローバル設定は通常ServBayの/etcで管理しません。
Node.js, Go, Java, Ruby, Rust, .NET: これらの言語もPython同様、プロジェクトや環境変数・個別ツールチェーンでの設定が一般的で、ServBayの/etc配下で一括管理はしていません。ServBayでは主にランタイムやSDKのみ提供します。

データベース

データベースの設定ファイルは、/Applications/ServBay/etc および /Applications/ServBay/db 内のいずれかに分散して保存されます。

MySQL / MariaDB: 設定ファイル主パス：/Applications/ServBay/etc/mysql（MariaDBは/Applications/ServBay/etc/mariadb）例：MySQL 8.0の設定ファイル
```
/Applications/ServBay/etc/mysql/8.0/my.cnf
```
1
データベースの主な設定パラメータが記載されています。
PostgreSQL: メイン設定ファイルは/Applications/ServBay/etc/postgresql に保存され、バージョンごとに分類。例：PostgreSQL 16の設定ファイル
```
/Applications/ServBay/etc/postgresql/16/postgresql.conf
```
1
一方でクライアント認証関連（pg_hba.conf, pg_ident.conf）は /Applications/ServBay/db/postgresql 内に同じくバージョンごとに保存されています。
```
/Applications/ServBay/db/postgresql/16/pg_hba.conf
/Applications/ServBay/db/postgresql/16/pg_ident.conf
```
1
2
MongoDB, Redis: 通常、/Applications/ServBay/etc 配下でソフトウェア名・バージョンごとに分けて設定保存。例：Redisの設定ファイル
```
/Applications/ServBay/etc/redis/redis.conf
```
1

その他サービス・共通パッケージ

OpenSSL: 設定ファイルは /Applications/ServBay/package/common/openssl 内に、バージョン別で保存。例：OpenSSL 3.2
```
/Applications/ServBay/package/common/openssl/3.2/openssl.cnf
```
1
ACME（SSL証明書自動取得用）: ACME関連の設定や証明書は /Applications/ServBay/etc/acme または /Applications/ServBay/db/acme に保存されます。

設定ファイルの探索・閲覧方法

編集は推奨されませんが、現行の設定確認やトラブル時にファイル内容を閲覧する必要がある場合には、以下の手順で調べることができます。

ディレクトリへ移動： ターミナル（TerminalやiTerm2等）で該当ディレクトリへ移動します。
例：Nginxの設定ファイルディレクトリを表示
bash
```
cd /Applications/ServBay/etc/nginx/
```
1
PostgreSQL 16のpg_hba.confディレクトリを表示
bash
```
cd /Applications/ServBay/db/postgresql/16
```
1
ファイル一覧の表示：ls コマンドを使ってファイルを一覧表示します。
bash
```
ls
```
1
ファイル内容を見る： テキスト閲覧コマンド（cat, less, more）やエディタ（vim, nanoなど- 閲覧のみ。変更は保存しないでください）でファイル内容を確認します。
例：Nginxのnginx.confを確認
bash
```
cat nginx.conf
# または less でページ送り閲覧
less nginx.conf
```
1
2
3
PHP 8.2のphp.iniを確認
bash
```
less /Applications/ServBay/etc/php/8.2/php.ini
```
1
（ServBay UI経由で設定変更した場合）サービス再起動： ServBay UIで設定を変えた場合は、対応パッケージの再起動が必要です。ServBay管理画面またはservbayctlコマンドで再起動可能。例：Nginxサービスの再起動
bash
```
servbayctl restart nginx -all
```
1
PHP 8.2サービスの再起動
bash
```
servbayctl restart php 8.2
```
1
全サービス一括再起動
bash
```
servbayctl restart all
```
1

よくある質問（FAQ）

質問：高度な設定テストのため、設定ファイルを手動編集しても大丈夫ですか？
回答：強く非推奨です。ServBay UIでほとんどの一般的設定は調整可能です。どうしてもUIで設定できない高度なカスタマイズが必要な場合は、ServBayの上級者向けドキュメントを参照するか、コミュニティに問い合わせてください。手動編集内容は容易に上書きされてしまいます。
質問：ServBayは複数バージョンの設定ファイル管理をどう行っていますか？
回答：本ドキュメント記載の通り、/Applications/ServBay/etcや/Applications/ServBay/db配下に、ソフトウェアごとおよびバージョンごとに個別ディレクトリを作成することで、バージョン間の設定干渉を防ぎます。
質問：設定ファイルを誤って削除・破損した場合は？
回答：ServBayは内蔵テンプレートと現在のUI設定に基づき設定ファイルを自動生成するため、UIで軽微な設定変更をして再適用すれば、基本的には再生成されます。万一うまく再生成できない場合、各ソフトの設定をリセットする・ServBayサポートへ連絡するなどの対応が推奨されます。

総括

ServBayは、主に /Applications/ServBay/etc ディレクトリを中心として、/Applications/ServBay/db・/Applications/ServBay/package/common と組み合わせた一元・構造化管理方式を採用しています。この構造によりServBay自身による自動管理や開発者のファイル探索が容易です。

これらファイル位置を理解することは、ServBayの仕組み把握や不具合時のトラブルシューティングに大変役立ちます。繰り返しになりますが、全ての設定変更はServBayの公式UIまたはツール経由で行い、直接ファイル編集は絶対に避けましょう。ServBay環境の安定運用のためご協力ください。

ServBay 設定ファイルの保存場所と管理 ​

ディレクトリ構成の概要 ​

ソフトウェア別 設定ファイル保存場所 ​

Webサーバー ​

言語ランタイム ​

データベース ​

その他サービス・共通パッケージ ​

設定ファイルの探索・閲覧方法 ​

よくある質問（FAQ） ​

総括 ​