---
title: "インストールと起動"
description: "Notarium を単一の Docker コンテナで立ち上げ、localhost:3000 で開き、オーナーを作成する初回起動のセットアップ画面をひと通り進める。"
---

# インストールと起動

Notarium は**単一の自己完結型イメージ**として配布されます。ひとつのプロセスが Web インターフェース、REST API、エージェント向けの MCP エンドポイントを提供し、ナレッジエンジンはそのすぐ内側で動きます。外部サービスは一切不要で、データベースもメッセージブローカーも独立した検索エンジンもいりません。始めるのに必要なのは Docker と空いているポートだけです。

このページは最短ルートです。インスタンスを立ち上げ、ブラウザで開き、オーナーを作成します。本格的なセルフホスト(Postgres、リバースプロキシ、本番構成)は [セルフホスト](/docs/self-hosting/) セクションで扱います。

## 必要なもの

- **Docker**(または Docker Desktop)。ほかに入れるものはありません。Node もデータベースも検索インデックスも、すでにイメージの中にあります。
- 空いているポート。デフォルトは **3000** です。
- ノートと派生インデックスのための、少しのディスク領域。

## 単一コンテナで起動する

最短ルートは、ビルド済みの `docouno/notarium` イメージを実行することです。

```bash
docker run -d --name notarium \
  -p 3000:3000 \
  -v notarium-data:/data \
  docouno/notarium:latest
```

数秒後に `http://localhost:3000` を開きます。

`/data` というひとつのボリュームがすべての状態を保持します。メタデータデータベース、各種インデックス、あなたのノート、エクスポート成果物です。ほかに設定するものはありません。ポート 3000 と `/data` パスはすでにイメージに焼き込まれています。`3000` の左側のポートは、任意の空きポートに変更できます。

> [!note] ソースからのビルド
> イメージがまだレジストリから取得されていない場合は、Notarium の本体リポジトリで `make up` を使ってソースからビルドしてください(下記参照)。挙動は同一です。

もうひとつの方法は、Docker まわりのすべてを担う単一のエントリポイントである `make` を使ってソースからビルドすることです。

```bash
cp .env.example .env   # デフォルトのままで動く — 何も記入する必要はない
make up                # 本番イメージをビルドして起動する → http://localhost:3000
```

日々の運用にはほかのコマンドも役立ちます。`make logs` でログ、`make ps` でステータス、`make down` で停止と削除、`make sh` でコンテナ内のシェルです。

## ボリューム: データはどこにあるか

すべての状態はひとつのボリュームに収まります。コンテナを作り直すときに守るべきなのは、これだけです。

| ボリューム | マウントポイント | 保存するもの |
|---|---|---|
| `notarium-data` | `/data` | すべて: あなたのノート(`/data/spaces`)、メタデータデータベース(`/data/meta.db`)、派生した検索インデックス(`/data/engine`)、エクスポート成果物(`/data/jobs`) |

核心となる原則は**ファイルファースト**です。真実の源は `/data/spaces` にある `.md` ファイルです。`/data/engine` にある検索インデックスとグラフは派生物で、ファイルから再構築されるため、失っても再インデックスで戻せます。一方、メタデータデータベース `/data/meta.db`(バージョン履歴、ユーザー、アクセス権)はボリュームの中だけに存在するので、`/data` はノートと同じくらい大切に扱ってください。バックアップに必須なのはあなたのノートと `meta.db` だけで、派生インデックスは含めなくてかまいません。

> [!tip] 自分のポート
> `3000` ポートは `-p <自分のポート>:3000` の左側(または `.env` の `PORT` 変数)で変更します。イメージはコンテナのすべてのインターフェースで待ち受けますが、外に出るのはあなたがマッピングした分だけです。

## 初回起動: セットアップ画面

初めてアクセスすると、Notarium は**セットアップ画面**で出迎えます。あらかじめ設定されたパスワードはありません。最初の訪問者がインスタンスの**オーナー**を作成し、そのアカウントが管理者となり、作成されるスペースのオーナーになります。その後セットアップは二度と開かず、あなたはすでに自分の個人スペースの中にいるエディタへ着地します。

これがデフォルトの認証モード `AUTH_MODE=password` の動きです。これは公開到達可能なインスタンスを想定しています。ログイン、セッション、エージェント向けの個人トークンです。もうひとつのモード `none`(全アクセス権を持つ単一のプリンシパル、ログイン画面なし)は、デスクトップ、ローカル開発、閉じたイントラネットといった信頼できる環境にのみ適します。詳細は [認証](/docs/self-hosting/authentication/) セクションにあります。

## 基本の設定

デフォルトはゼロコンフィグで、始めるにはイメージそのままで十分です。細かな調整は環境変数で行います(Docker では `.env` がそれらを渡し、イメージには何も焼き込まれません)。

| 変数 | 値 | デフォルト |
|---|---|---|
| `PORT` | サーバーが待ち受けるポート | `3000` |
| `AUTH_MODE` | `password`(ログイン + セットアップ)または `none`(信頼できる環境) | `password` |
| `VECTOR_SEARCH` | 全文検索(字句検索)に加えてセマンティック検索(ベクトル検索)を有効にする | イメージでは `off` |

全文検索(字句検索)は常に、設定なしで動きます。セマンティック検索(ベクトル検索)は `VECTOR_SEARCH=on` フラグで任意に有効化します。これはローカルの埋め込みモデル(数百メガバイト単位の RAM)を引き込むため、公開イメージではオフで、意図的にオンにする必要があります。これがなくても検索は全文に対して動き続けます。エラーにはならず、これが通常のモードです。変数の一覧と検索のセットアップは [構成](/docs/self-hosting/configuration/) と [検索のセットアップ](/docs/self-hosting/search-setup/) のセクションにあります。

## 次のステップ

インスタンスが立ち上がり、オーナーが作成されました。ナレッジベースを満たし、それをエージェントに開放する番です。

- [最初のノート](/docs/getting-started/first-note/) — ファイルツリー、Web エディタ、`.md` への保存。
- [エージェントを接続する](/docs/getting-started/connect-agent/) — トークン、`POST /mcp` エンドポイント、最初の呼び出し。

モデル全体を理解したいですか。[コンセプト](/docs/concepts/) セクションをご覧ください。スペース、ノートの種類、グラフ、アクセスモデルを扱います。