インストール

basedbは1つのDockerイメージeodia/basedb（amd64とarm64）に収まっています。インターフェース、API、MCPサーバーが、1つのアドレスで提供されます。必要なのはPostgreSQL 16のデータベースで、これはdocker-compose.ymlが用意します。

Docker Composeを使う（推奨）

前提条件：Docker と Compose v2。必要なのはファイル2つだけで、ソースコードは不要です：

mkdir basedb && cd basedb
curl -fsSLO https://raw.githubusercontent.com/eodia/basedb/main/docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/eodia/basedb/main/.env.example -o .env

.envを開き、必須の2つの値だけを設定します：

POSTGRES_PASSWORD=un-mot-de-passe-solide
# 一度だけ生成します：openssl rand -base64 32
BASEDB_ENCRYPTION_KEY=…

次に起動します：

docker compose up -d

初回起動時に、basedbはカタログを作成します。その後http://localhost:3000を開くと、最初のページで管理者アカウントの作成を求められます。名前、メールアドレス、任意のパスワードを入力すると、そのままログインした状態になります。

最初のアクセスで管理者が作成されます

管理者が存在しない間は、最初にインターフェースを開いた人が管理者を作成します。インスタンスを他の人がアクセスできる状態にする前に（ドメインで公開したり、すべてのネットワークインターフェースでポートを公開したりする前に）、管理者を作成してください。

無人インストールの場合は、.envのBASEDB_ADMIN_EMAILで管理者を指定します。basedbは初回起動時にその管理者を作成し、パスワードをログ（docker compose logs basedb）に一度だけ表示します。BASEDB_ADMIN_PASSWORDでパスワードを固定することもできます。

アドレス	役割
http://localhost:3000	インターフェース
http://localhost:3000/api	REST APIとそのドキュメント
http://localhost:3000/mcp	エージェント向けのMCPサーバー
localhost:5432	psqlや各種ツール向けのPostgreSQL

ポートは127.0.0.1にのみ公開されます。basedbをドメインで提供するには、ドメインとHTTPSをご覧ください。

独自のPostgreSQLを使う

PostgreSQL 16以上のデータベース（データベースの所有者ロールがあり、pg_trgmとunaccent拡張が利用できること）があれば、イメージだけで動きます：

docker run -d --name basedb -p 3000:3000 -v basedb-files:/data \
  -e DATABASE_URL=postgres://basedb:secret@db.example.com:5432/basedb \
  -e BASEDB_ENCRYPTION_KEY="$(openssl rand -base64 32)" \
  eodia/basedb

生成したキーは必ず保管してください（下記の注意を参照）。

インスタンスキー

BASEDB_ENCRYPTION_KEYはセッションに署名し、保存されたシークレット（AIのキー、Webhookのシークレット、オートメーションのシークレットヘッダー、フォームのリンク）を暗号化します。変更するとすべてのユーザーがログアウトされ、これらのシークレットは読めなくなります。一度だけ生成し、データベースと一緒にバックアップしてください。

開発環境

前提条件：Node 22以上、Docker、そしてcorepack enable。

corepack pnpm install
corepack pnpm exec tsc -b packages/naming packages/contracts packages/catalog-schema packages/core apps/api apps/mcp
corepack pnpm start

pnpm startは空いているポートを選び、使い捨てのPostgreSQL 16を起動し、カタログを適用し、開発用の管理者（admin@basedb.local / developpement-basedb。ログイン画面にアドレスが入力済み）を用意してから、API、MCPサーバー、インターフェースを開発モードで起動します。Ctrl+Cで、コンテナも含めてすべて停止します。

次のステップ

• クイックスタート：データベース、テーブル、ビュー、フォーム。
• 環境変数：ファイル、AI、アドレス。