Open Notebookの使い方｜Dockerで起動して最初の資料を追加するまで

Open Notebookは、自分で管理する環境へ資料を追加し、AIとのチャット、ノート作成、検索などを行えるオープンソースのAIリサーチツールです。

公式のクイックスタートはDocker Desktopを前提としています。本記事では、コマンドを実行する前に保存場所と暗号化キーを決め、起動後に最初の資料を追加するまでを整理します。

この記事でわかること

• Open Notebookの使い方の具体的な確認手順
• 原因を一つずつ切り分ける方法
• 再発時に残しておく情報

Open Notebookでできること

• PDF、Webページ、音声、動画、テキストなどを資料として整理する
• 資料を選んでAIへ質問する
• 要約やメモを作成する
• 全文検索とベクトル検索を使い分ける
• クラウドAIまたはOllamaなどのローカルAIを選ぶ

自分で運用するため、アップデート、バックアップ、AI利用料、アクセス制御も利用者が管理します。

準備するもの

1. Docker Desktopが動くPC
2. 設定ファイルを置く専用フォルダ
3. クラウドAIのAPIキー、またはOllamaなどのローカルAI
4. テスト用の小さなPDFやWebページ

会社や学校のPCではDockerの利用が制限されている場合があります。管理ポリシーを確認してください。

手順1：Docker Compose設定を用意する

公式リポジトリの最新READMEからdocker-compose.ymlを取得します。古いブログ記事の設定をそのまま使わず、現在の公式ファイルと差分を確認してください。

OPEN_NOTEBOOK_ENCRYPTION_KEYはAPIキーをデータベース内で暗号化するための値です。サンプルのまま使わず、自分用の十分に長い値へ変更し、安全な場所へ保管します。

手順2：サービスを起動する

設定ファイルを置いたフォルダでdocker compose up -dを実行します。公式READMEでは、起動後にhttp://localhost:8502を開く流れが案内されています。

画面が開かない場合はdocker compose psとdocker compose logsを確認します。ポート8502や5055が別のアプリに使われていないかも確認してください。

手順3：AIプロバイダーとモデルを登録する

設定画面でAIプロバイダーの認証情報を追加し、接続テスト、モデル検出、モデル登録の順に進みます。APIキーを記事、スクリーンショット、共有設定ファイルへ書かないでください。

最初は高速で小さいモデルを一つ登録し、資料追加とチャットが動くことを確認します。複数プロバイダーの設定は、基本動作を確認してから追加します。

手順4：最初のノートブックと資料を追加する

用途が分かる名前でノートブックを作成し、小さなPDFまたはWebページを一つ追加します。資料が処理済みの状態になってから、内容に含まれる固有の質問をします。

最初から大量の資料を入れると、失敗したファイルや回答の根拠を追いにくくなります。1件で成功した後、同じ種類の資料を数件ずつ増やしてください。

最初に行うバックアップ確認

Docker Composeでマウントしているデータフォルダと、設定ファイルを確認します。APIキーそのものと、復元に必要な暗号化キーは別の安全な方法で管理してください。

アップデート前にバックアップを作り、テスト用ノートブックで起動確認してから重要な資料を扱うと安全です。

まとめ

一度に複数の設定を変えず、同じ条件で比較することが解決への近道です。最初の状態、変更した項目、結果を短く記録しておけば、再発時にも無駄な再インストールや買い替えを避けやすくなります。

関連するLEXIAの記事

• NotebookLMのオープンソース代替まとめ
• Open Notebook向けスキャナーの考え方
• Ollamaに接続できないときの確認手順

参考にした公式情報

• Open Notebook公式リポジトリ
• Open Notebook公式Start Here