データベースデプロイガイド

Dokploy UIを使ってデータベースサービスを作成・デプロイ・管理する方法

Dokploy の UI を使ってデータベースサービスを作成・デプロイ・管理する手順を説明します。

対応データベース

データベース	説明	デフォルトポート
PostgreSQL	堅牢で SQL 標準に準拠した高信頼性のリレーショナルデータベース	5432
MySQL	パフォーマンスと柔軟性に優れた、広く普及しているリレーショナルデータベース	3306
MariaDB	MySQL から派生し、追加機能とパフォーマンス改善が施されたリレーショナルデータベース	3306
MongoDB	高いスケーラビリティと柔軟性を持つ NoSQL データベース。JSON ライクなドキュメント形式でデータを格納する	27017
Redis	インメモリ型のキーバリューストア。データベースとしてだけでなく、キャッシュやメッセージブローカーとしても利用される	6379

迷ったら PostgreSQL がおすすめです。 幅広い用途に対応でき、信頼性・機能面ともにバランスが良い定番のデータベースです。キャッシュやセッション管理など一時的なデータの高速な読み書きが目的であれば Redis を選択してください。

1. データベースの作成

1.1 プロジェクトを開く

サイドバーから Projects をクリック
対象のプロジェクトを選択
デプロイ先の Environment（環境） を開く

1.2 データベース作成ダイアログを開く

Environment ページ右上の + Create Service ボタンをクリック
ドロップダウンから Database を選択
データベース作成ダイアログが表示される

1.3 データベースタイプを選択

ダイアログ上部のアイコン付きカードから、使用するデータベースを選択します:

データベース作成ダイアログ

1.4 フォームを入力

全データベース共通のフィールド

フィールド	必須	説明
Name	✅	表示名。入力すると App Name が自動生成される
App Name	✅	Docker Swarm サービス名。`{プロジェクトslug}-{名前slug}` の形式で自動生成されるが手動編集も可能。小文字英数字と `-` のみ使用可
Description	-	任意の説明文
Database Password	✅	パスワードジェネレーター付き。`$ ! ' " \ /` およびスペースは使用不可
Docker Image	-	空欄の場合はデフォルトイメージが使用される

Database Name・Database User・Database Password は、アプリケーションからデータベースに接続する際に必要な情報です。作成後に Internal Connection URL として確認できるので、特にこだわりがなければデフォルト値のままで問題ありません。

データベースタイプ別の追加フィールド

フィールド	PostgreSQL	MySQL	MariaDB	MongoDB	Redis
Database Name	✅ (default: `postgres`)	✅ (default: `mysql`)	✅ (default: `mariadb`)	-	-
Database User	✅ (default: `postgres`)	✅ (default: `mysql`)	✅ (default: `mariadb`)	✅ (default: `mongo`)	-
Database Root Password	-	任意	任意	-	-
Use Replica Sets	-	-	-	トグルスイッチ	-

MongoDB の Replica Sets を有効にすると、レプリカセット rs0 が自動初期化され、root ユーザーが作成されます。

1.5 作成を実行

Create ボタンをクリックするとデータベースが作成されます。

この時点ではまだデータベースは起動していません。次のステップでデプロイ（起動）を行います。

2. データベースのデプロイ

2.1 データベース詳細ページを開く

Environment ページのサービス一覧から、作成したデータベースをクリックして詳細ページを開きます。

2.2 デプロイを実行

General タブの Deploy Settings カードを確認
Deploy ボタン (🚀) をクリック
確認ダイアログで Confirm をクリック
デプロイログが表示され、「Deployment completed successfully!」と出たら成功です

2.3 デプロイ後のアクション

デプロイ後のアクションボタン

ボタン	説明
Deploy	データベースを再デプロイする
Reload	データベースを再起動する
Stop	データベースを停止する
Open Terminal	コンテナ内のシェルに接続する

3. 接続情報の確認

General タブにはデプロイ後に2種類の接続情報が表示されます。

3.1 Internal Credentials（内部接続）

Dokploy 上の他のサービスから接続する場合に使用します。

項目	説明	例 (PostgreSQL)
User	データベースユーザー名	`postgres`
Database Name	データベース名	`postgres`
Password	パスワード（マスク表示）	`***`
Internal Port	コンテナ内ポート	`5432`
Internal Host	Docker Swarm ネットワーク上のホスト名	`myproject-mydb`
Internal Connection URL	完全な接続文字列	`postgresql://postgres:****@myproject-mydb:5432/postgres`

Internal Host は App Name と同じ値です。同じ Docker Swarm ネットワーク上のサービスからはこのホスト名で直接アクセスできます。

3.2 アプリケーションからの接続方法

作成したデータベースにアプリケーションから接続するには、Internal Connection URL を環境変数として設定します。

Internal Credentials の Internal Connection URL をコピーする
接続元のアプリケーションの Environment タブを開く
環境変数として設定する（例: DATABASE_URL=postgresql://postgres:****@myproject-mydb:5432/postgres）
アプリケーションを Deploy（再デプロイ）する

環境変数名はアプリケーション側の実装に合わせてください。一般的には DATABASE_URL がよく使われます。