独自のドメインにカスタムMatrixルームエイリアスを設定する
ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。
Element Web をセルフホストでデプロイする場合は、アプリ名とデフォルトテーマを に設定しconfig.json、brandingログインロゴ、背景、ロゴリンク、フッターリンクについてはドキュメントに記載されているオプションを使用してください。カスタムカラーを設定するには、 の下にテーマを定義しsetting_defaults.custom_themes、default_themeそのcustom-名前を指定します。これらの設定により Element はパーソナライズされますが、完全なホワイトラベル製品にはなりません。
Elementの設定では、製品の識別情報、カラーテーマ、ページアセットを分離できます。目的を達成するために必要な最小限の変更を選択してください。
| 目標 | 設定 | 変更内容 |
|---|---|---|
| サービス名を表示 | brand | さまざまな文字列と場所におけるアプリ名 |
| ライト、ダーク、またはカスタムのスタートテーマを設定します。 | default_theme | デプロイメントのデフォルトカラーテーマ |
| ログイン画面とウェルカム画面の表示を変更する | branding | 認証ページのロゴ、背景、ロゴリンク、およびフッターリンク |
| カスタムカラーとフォントを設定する | setting_defaults.custom_themes | テーマオプション(カラートークンやフォントファミリーなど) |
検証済み: Elementのドキュメントによると、一部のカスタマイズはサポートされていますが、完全なリブランディングやプライベートラベル化はサポートされていません。実際的な意味合い:変更してもbrand、すべてのロゴ、アイコン、画像、または製品参照が置き換えられるわけではありません。すべてのビジュアルと文字列を変更する必要がある場合は、カスタマイズされたビルドを維持し、アップグレード後に再確認する必要があります。設定のみのアプローチを選択する前に、まずユーザーが見る必要のある正確なUI要素をリストアップしてください。
Element Web はconfig.json起動時にファイルを読み込みます。デフォルトのホームサーバーなどの必要な設定を保持するために、現在のファイルをバックアップしてからその場で編集してください。リリース版の tarball の場合、ファイルはデプロイされた Web ディレクトリにあります。Debian パッケージ/etc/element-web/config.jsonでは を使用します。Docker を使用する場合は、設定ファイルを にマウントしてください/app/config.json。正しい場所は Element のインストール方法によって異なるため、編集する前にデプロイ方法を確認してください。
既存のJSONオブジェクトに以下のキーを追加し、既に存在する設定と組み合わせます。この内容を構成全体の置き換えとして貼り付けないでください。
{
"brand": "Northstar Chat",
"default_theme": "dark",
"permalink_prefix": "https://chat.example.org",
"branding": {
"logo_link_url": "https://example.org",
"auth_header_logo_url": "https://chat.example.org/assets/logo.svg",
"welcome_background_url": "https://chat.example.org/assets/welcome.jpg",
"auth_footer_links": [
{ "text": "Help", "url": "https://example.org/help" },
{ "text": "Privacy", "url": "https://example.org/privacy" }
]
}
}
例の名前、ホスト名、アセットを自分のものに置き換えてください。brandはさまざまな場所でアプリ名を変更し、permalink_prefix共有パーマリンクが ではなく Element デプロイメントを指すようにしますmatrix.to。 ロゴと背景エントリは、ブラウザによって読み込まれる URL です。ユーザーがアクセスできる場所から HTTPS 経由で提供し、アクセス制御、コンテンツ セキュリティ ポリシー、キャッシュによってブロックされないことを確認してください。 ドキュメントには認証ロゴの汎用画像サイズが指定されていないため、固定サイズを想定するのではなく、実際のアセットをプレビューしてください。
展開方法によります。設定ファイルは、それを配信するElement Webインスタンスに影響を与えます。公式app.element.ioサービスを変更したり、Elementの個別のモバイルアプリやデスクトップアプリを自動的に変更したりするものではありません。独自のインスタンスを配信するホストまたはコンテナ上で編集を行ってください。
シンプルな色とフォントのテーマの場合、Element はカスタムテーマの定義を 内に記述しますsetting_defaults.custom_themes。テーマの内部名は で始まります。 ではcustom-その完全な名前を使用しますdefault_theme。この例はコンパクトなカスタムテーマを示しています。これは出発点であり、完全なパレットではありません。
{
"default_theme": "custom-Northstar",
"setting_defaults": {
"custom_themes": [
{
"name": "Northstar",
"is_dark": false,
"fonts": {
"general": "Inter, sans-serif",
"monospace": "'Courier New'"
},
"colors": {
"accent-color": "#3157A4",
"primary-color": "#3157A4",
"warning-color": "#B5473C",
"sidebar-color": "#202A3B",
"roomlist-background-color": "#F3F5F8",
"roomlist-text-color": "#202938",
"timeline-background-color": "#FFFFFF",
"timeline-text-color": "#202938"
}
}
]
}
}
これらのキーは、2つ目のオブジェクトを作成するのではなく、既存のJSONにマージしてくださいsetting_defaults。テキスト、背景、コントロールのコントラストは、通常状態とハイライト状態の両方で読みやすいようにしてください。Elementのテーマリファレンスには、追加のオプションカラー、ユーザー名とアバターのカラー配列、カスタムフォント、複合デザイントークンが含まれています。現在のリファレンスで確認済みの値のみを追加してください。不完全なパレットを使用すると、インターフェースの一部でデフォルト値が使用される可能性があります。
よくある誤解:この設定はdefault_themeデプロイメントのデフォルトを選択するものであり、ドキュメントにはすべてのユーザーの外観設定をロックするポリシーとして記載されていません。厳密にテーマを強制する必要がある場合は、デフォルトがロックであると想定するのではなく、実際に使用しているElement Webのリリースバージョンでその動作を確認してください。
ランタイムテーマのテストについては、Elementのテーマに関する説明で、/devtools「カスタムテーマ」からJSONテーマURLを読み込む方法が示されています。これはテストまたはユーザー側のワークフローとして扱い、意図した設定をすべてのクライアントに展開する代替手段としては使用しないでください。保守性の高い展開を実現するには、設定とアセットをバージョン管理下に置き、Element Webをアップグレードする際にこの確認を繰り返してください。
ここで説明する動作は、2026年10月10日に確認された公式のElement Web設定およびテーマ設定ドキュメントに準拠しています。設定を使用する前に、インストールされているリリースのリファレンス(Element Web設定リファレンス、Element Webテーマ設定ドキュメント、Element Webインストールドキュメント)を確認してください。
ElementまたはMatrix APIを使用して、権限、Synapse命名規則、およびフェデレーションのチェックを行いながら、ドメイン上の共有しやすいMatrixルームのアドレスを設定できます。
coturnとSynapseを一致するTURN認証情報で設定し、必要なリレーポートを開き、Matrixクライアントがリレー候補を取得できることを確認します。
Docker Compose、PostgreSQL、プライベート設定、およびHTTPS経由で公開する前にチェックを行う機能を備えた、永続的なSynapseホームサーバーをセットアップします。
Element Web デプロイメント用にブランド名、カスタムカラー、ログインアセットを設定すると同時に、どの部分が Element ブランドのままになるかを理解してください。
Synapseがプロセスごとのオープンファイル数の上限に達したかどうかを診断し、適切なサービスまたはワーカーに対してsystemdのドロップインを設定し、実際の制限を確認します。
エラーが特定のブラウザまたは特定のイベントに限定されているかどうかを確認し、残りの暗号化された履歴を危険にさらすことなく、Elementのリカバリキーまたは信頼できるデバイスを使用してください。
Synapseの履歴およびメディア消去APIまたは保持設定を使用して、古いデータを安全に削除し、完了とディスク容量の回復を確認してください。
最新のライブラリをインストールし、専用のMatrixアカウントに接続して、より安全な認証情報処理と明確なテストを備えた小型の!echoボットを実行します。
登録、ログイン、テストをそれぞれ別々に行う3つのmautrixブリッジを設定することで、Dockerのネットワーク、アカウントポリシー、同期に関する予期せぬ問題を回避できます。
Synapseストレージを占有しているファイルを特定し、安全なメディア保持期間を設定し、ディスクから直接ファイルを削除することなくリモートキャッシュを消去します。