Hypothesis(セルフホスト）

Hypothesis はオープンソースの Web アノテーションツールです。h はそれを支えるサーバーで、アノテーション用の Web アプリと公開アノテーション API を提供します。セルフホストすれば、あなたとコラボレーターは自分で管理するインフラ上で、あらゆる Web ページや PDF にハイライト・注釈・ディスカッションを残せます。

このテンプレートは 4 つのサービスをまとめてデプロイし、ワンクリックで動くスタックを構成します:

hypothesis — h サーバー（Web アプリ、API、リアルタイム WebSocket、バックグラウンドワーカー）
postgresql — アカウント・グループ・アノテーションを保存
elasticsearch — アノテーション検索（Hypothesis の ICU 同梱ビルドを使用）
rabbitmq — バックグラウンドワーカー用のメッセージブローカー

はじめに

使用したいドメインを入力し、Deploy をクリックします。
4 つのサービスのデプロイ完了を待ちます。hypothesis サービスは初回起動時に一度だけ初期化（データベーススキーマ、検索インデックス、管理者アカウントの作成）を実行するため、初回起動には数分かかります。これは正常です。
ドメインを開くと Hypothesis のトップページが表示されます。

カスタムドメインの利用

アノテーションの authority と公開 URL は、デプロイ時にドメインから導出されます。カスタムドメインを使いたい場合は、初回デプロイの前にバインドしてください。そうでなければ再デプロイが必要になります:アカウントやアノテーションが存在した後にドメインを変更すると、それらは古い authority に紐づいたままになります。

重要な注意事項

アノテーション用クライアントは https://cdn.hypothes.is から読み込まれます。 これは Hypothesis のデフォルト動作で、クライアントを常に最新に保ちます。アノテーションの「データ」はすべてあなたのインスタンスに残ります。
メールは設定されていません。 アカウント有効化はスキップされ、パスワードリセットメールも送信されません。送信するには hypothesis サービスに MAIL_* 環境変数を追加してください。
データは postgresql と elasticsearch のボリュームに保存されます。 hypothesis サービス自体はステートレスです。これらのボリュームを削除しないでください。
PostgreSQL・Elasticsearch・RabbitMQ の各サービスはプロジェクトのプライベートネットワーク内からのみ到達可能です。特に Elasticsearch には認証がないため、外部公開しないでください。

帰属とライセンス

Hypothesis(h)は Hypothes.is Project と貢献者によって開発され、BSD-2-Clause ライセンスで公開されています。このテンプレートは公式の hypothesis/hypothesis Docker イメージを Zeabur 上でデプロイできるようにパッケージ化したものであり、Hypothes.is Project とは提携・推奨関係にありません。

ソースコード:https://github.com/hypothesis/h
公式サイト:https://web.hypothes.is/

変更履歴

2026-05-14:初回リリース。hypothesis/hypothesis:20260504-g4d0056f をベースにしています。

Hypothesis

サービス

postgresql

elasticsearch

rabbitmq

hypothesis