Bedrud 文档

The built-in installer configures a fresh Linux server for production use with a single command.

安装程序的工作流程

运行 bedrud install 时，会执行以下操作：

步骤 操作
1 创建目录： /etc/bedrud, /var/lib/bedrud, /var/log/bedrud
2 将二进制文件复制到 /usr/local/bin/bedrud
3 根据你的设置生成 config.yaml /etc/bedrud/config.yaml
4 为媒体服务器生成 livekit.yaml /etc/bedrud/livekit.yaml
5 创建两个 systemd 服务： bedrud.service & livekit.service
6 启用并启动两个服务
7 初始化 SQLite 数据库和证书缓存

Systemd 服务

安装程序会创建两个 systemd 服务：

服务 命令 用途
bedrud.service bedrud --run --config /etc/bedrud/config.yaml API + Web
livekit.service bedrud --livekit --config /etc/bedrud/livekit.yaml 媒体服务器

Security and TLS

The installer handles security automatically:

  • ACME (Let’s Encrypt): If you provide a domain and email, it sets up automatic certificate renewal.
  • Self-Signed Certs: If no domain is provided, it generates a self-signed certificate so that the site still works over HTTPS. The server auto-renews the certificate daily when it’s within 30 days of expiry. Use bedrud cert renew for manual renewal.
  • Reverse Proxy: The backend acts as a reverse proxy. It receives traffic on port 443 and sends /livekit requests to the internal media server.

Updating

In-place upgrade (preserves config and database):

sudo bedrud update
# alias:
sudo bedrud upgrade

Replaces the binary with the running executable, runs versioned install migrations and DB AutoMigrate, refreshes init units, and restarts services. See Updating.

Uninstallation

If you need to remove Bedrud, you can run:

sudo bedrud uninstall

This stops the services, deletes the init service files (systemd, OpenRC, or SysV init), and removes the configuration and data folders.

See also