First commit

doc/installation.md

@@ -0,0 +1,54 @@
+# ネイティブ版のインストール
+
+## ビルド
+
+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は必須ではなく、現段階では配布対象に含めていません。