Files
mirakurun-rs/doc/installation.md
2026-07-31 14:39:33 +09:00

55 lines
1.8 KiB
Markdown

# ネイティブ版のインストール
## ビルド
Rust 1.85以降と、Web UIを再ビルドする場合のみNode.js/npmを用意します。
```console
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で起動
以下は管理者権限で実行する例です。既存ファイルを上書きする前に退避してください。
```console
install -Dm755 target/release/mirakurun-rs /usr/local/bin/mirakurun-rs
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` ユーザーへその
補助グループを追加します。外部チューナー・デコーダーコマンドも、このユーザーで
実行できる必要があります。
## 手動起動
任意のディレクトリだけで試す場合は各パスを明示できます。
```console
./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は必須ではなく、現段階では配布対象に含めていません。