Bedrud ドキュメント

5 分以内に Bedrud をデプロイしてビデオ会議に参加しましょう。

本ガイド:

  1. CLI を取得 — ワンコマンドインストール（または手動ダウンロード）
  2. サーバーをデプロイ — bedrud install ですべてをセットアップ
  3. 確認 — サービスが動作しているか確認
  4. 管理者作成 & 参加 — ブラウザを開き、自分を管理者に昇格させ、会議を開始

詳細情報:

単一バイナリ、ダウンロード後はインターネット不要。 組み込みメディアサーバーと SQLite を含んでいるため、孤立したネットワークでも動作します。ファイルを転送して、コマンドを1つ実行するだけ。

必要なもの

要件詳細
Linux サーバーamd64 または arm64、sudo アクセスと systemd が必要。macOS/Windows: サーバーには Docker または WSL2 を使用
開放ポート8090、7880、50000–60000/udp。自動 TLS の場合: さらに 80 と 443
ドメイン（任意）このサーバーを指す DNS A レコード。ドメインなし？IP でも動作 - 以下の代替方法を参照

仕組み: 1つの Bedrud サーバー を実行します。参加者は ブラウザ で会議に参加（インストール不要）、または ネイティブアプリ 経由（Android、Windows、macOS、Linux）で参加します。

1. Bedrud CLI を取得

curl -fsSL https://get.bedrud.org | bash

インストール後にシェルを再読み込み:

source ~/.bashrc  # or ~/.zshrc

確認:

bedrud --version

フラグ（--version、--install-dir、--skip-shell、オフラインインストール）については、CLI インストーラー を参照。

irm https://get.bedrud.org/install.ps1 | iex

ターミナルを閉じて再び開き、確認:

bedrud --version

手動でダウンロードして展開します。linux_amd64 をお使いのプラットフォーム（linux_arm64、darwin_amd64、darwin_arm64）に置き換えてください:

curl -fsSL -o bedrud.tar.xz https://github.com/bedrud-ir/bedrud/releases/latest/download/bedrud_linux_amd64.tar.xz
tar -xJf bedrud.tar.xz
chmod +x bedrud
sudo mv bedrud /usr/local/bin/

すべてのプラットフォームターゲットについては、CLI インストーラー を参照。

サーバーにインターネットがない場合？ 任意のマシンでダウンロードし、USB または scp bedrud.tar.xz user@server:/tmp/ で転送してから展開してください。バイナリは完全に自己完結しています — 転送後の外部リクエストはゼロです。

ダウンロードに失敗？ インターネットアクセスを確認するか、URL を github.com/bedrud-ir/bedrud/releases で確認してください。

2. サーバーをデプロイ

サーバーセットアップには systemd 搭載の Linux が必要です。 macOS と Windows では bedrud install を直接サポートしていません — 代わりに Docker または WSL2 を使用してください。

meet.example.com と admin@example.com を実際の値に置き換えてください:

sudo bedrud install --tls --domain meet.example.com --email admin@example.com

サーバーバイナリを /usr/local/bin にインストールし、設定を生成し、systemd サービスを作成し、TLS をプロビジョニングし、すべてを起動します。

ポート 80 または 443 が使用中？ 競合するサービスを停止: sudo systemctl stop nginx apache2 caddy、その後再実行。

ドメインなし？ サーバー IP を使用:

sudo bedrud install --tls --ip 1.2.3.4

自己署名証明書を使用します。ブラウザに警告が表示されますがビデオは動作します。内部ネットワークで信頼済み証明書を使用する方法については、内部 TLS ガイド を参照。

3. 確認

curl -s -o /dev/null -w "%{http_code}" http://localhost:8090

期待される結果: 200

200 ではない？ サービスの状態を確認: sudo systemctl status bedrud livekit。ログを確認: journalctl -u bedrud -u livekit --no-pager -n 50。

4. アカウント登録 & 管理者作成

ブラウザで https://meet.example.com（または https://<your-ip>:8090）を開きます:

Promote User to Admin

Register via the web UI at your server URL, then promote the user to admin:

Alternatively, create a new admin user directly: 

				
sudo ./bedrud user create --email admin@example.com --password secret --name "Admin"
sudo ./bedrud user promote --email admin@example.com
  1. ログイン（またはリロード）— サイドバーに 管理者 セクションが表示されます（概要、ユーザー、ルーム、設定）。成功: 管理者になりました。
  2. ルームを作成 → 参加 → ビデオ/音声を共有 — カメラ/マイクの許可を求められたら許可

管理画面 — 昇格後、ログインして /dashboard/admin にアクセスできます。ユーザー、ルーム、システム設定、招待トークンを管理できます。

CLI リファレンス — 完全なユーザー管理: bedrud user promote、demote、create、delete。

Android、Windows、macOS、Linux 用 ネイティブクライアント: GitHub Releases。または会議リンクを共有 — 参加者は任意のブラウザで参加できます。

その他のインストール方法

Docker

docker run -d --name bedrud \
  -p 8090:8090 \
  -p 7880:7880 \
  -p 50000-60000:50000-60000/udp \
  -v bedrud-data:/var/lib/bedrud \
  ghcr.io/bedrud-ir/bedrud:latest

カスタム設定、Docker Compose、環境変数については Docker ガイド を参照。

ソースからビルド

Go 1.24+ と Bun が必要:

git clone https://github.com/bedrud-ir/bedrud.git
cd bedrud
make init
make local-run

make init で LiveKit のインストール、設定の作成、依存関係の取得を行います。make local-run でビルドして http://localhost:8090 で起動します。

プレーン HTTP（開発 / localhost のみ）

sudo bedrud install --ip 127.0.0.1

注意: ブラウザは localhost 以外の非 HTTPS でカメラ/マイクをブロックします。HTTP は開発専用です。

非 Linux システム

bedrud install コマンドは systemd サービスを設定するため Linux のみ対応です。CLI インストーラー（ステップ 1）はすべてのプラットフォームで動作し、バイナリを PATH に配置します。サーバーセットアップには Docker または WSL2 を使用してください。

OS方法
macOSCLI インストーラーが ~/bin/ に自動インストール
WindowsCLI インストーラーが %USERPROFILE%\bin\ に自動インストール
DockerDocker が動作するすべての OS で対応（上記参照）

内部ネットワーク

パブリックドメインや外部インターネットがない場合？プライベート CA セットアップとクライアントトラストストアの設定については 内部 TLS ガイド を参照。

設定

インストーラーは /etc/bedrud/config.yaml を生成します。デフォルト設定はほとんどの環境で機能します。 本番環境では jwtSecret と sessionSecret を変更し、再起動します:

sudo systemctl restart bedrud livekit

ルームのキャパシティ、タイムアウト、メディアポートの調整については、設定の LiveKit セクション を参照。

完全なリファレンス: 設定

トラブルシューティング

問題解決策
ポート 80/443 が使用中sudo systemctl stop nginx apache2 caddy
サービスが開始しないjournalctl -u bedrud -u livekit --no-pager -n 50
TLS 証明書エラーDNS を確認: dig meet.example.com。サーバー IP を指している必要がある
ビデオなし / WebRTC 失敗カメラには HTTPS が必要。--tls を使用。ファイアウォールで UDP 50000–60000 を開放
LiveKit ポートの競合--lk-port、--lk-tcp-port、--lk-udp-port フラグを使用
ファイアウォールがメディアをブロックsudo ufw allow 8090/tcp && sudo ufw allow 7880/tcp && sudo ufw allow 50000:60000/udp
自己署名証明書の警告プライベート CA セットアップについては 内部 TLS ガイド を参照

クリーンアップ

# バイナリインストール
sudo bedrud uninstall
 
# Docker
docker stop bedrud && docker rm bedrud && docker volume rm bedrud-data
 
# ソースビルド
# Ctrl+C で停止、その後: make clean

次のステップ