mirakurun-rs/doc/installation.md

ネイティブ版のインストール

ビルド

Rust 1.85以降と、Web UIを再ビルドする場合のみNode.js/npmを用意します。

cd web
npm ci
npm run typecheck
npm run build
cd ..
cargo build --release --locked -p mirakurun-rs

target/release/mirakurun-rs はWeb UIを内包した実行ファイルです。本番実行時に Node.jsやnpmは不要です。

systemdで起動

以下は管理者権限で実行する例です。既存ファイルを上書きする前に退避してください。

install -Dm755 target/release/mirakurun-rs /usr/local/bin/mirakurun-rs
install -Dm644 LICENSE /usr/local/share/doc/mirakurun-rs/LICENSE
install -Dm644 dist/mirakurun-rs.service /etc/systemd/system/mirakurun-rs.service
install -Dm644 config/server.yml /etc/mirakurun/server.yml
install -Dm644 config/tuners.yml /etc/mirakurun/tuners.yml
install -Dm644 config/channels.yml /etc/mirakurun/channels.yml
useradd --system --home-dir /var/lib/mirakurun --shell /usr/sbin/nologin \
  --groups video mirakurun
systemctl daemon-reload
systemctl enable --now mirakurun-rs

チューナーデバイスに別のグループが必要な環境では、mirakurun ユーザーへその 補助グループを追加します。外部チューナー・デコーダーコマンドも、このユーザーで 実行できる必要があります。

手動起動

任意のディレクトリだけで試す場合は各パスを明示できます。

./target/release/mirakurun-rs \
  --server-config ./config/server.yml \
  --tuners-config ./config/tuners.yml \
  --channels-config ./config/channels.yml \
  --services-db ./data/services.json \
  --programs-db ./data/programs.json \
  --logo-dir ./data/logo-data \
  serve

Dockerは必須ではなく、現段階では配布対象に含めていません。