roji はじめる

インストール

Homebrew（macOS）

brew install kan/roji/roji

ワンライナーインストール（推奨）

Linux・macOS対応：

curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/kan/roji/main/install.sh | bash

実行内容：

  • プラットフォーム（Linux/macOS、x86_64/arm64）に合ったバイナリをダウンロード
  • リリースの checksums.txt と照合する。GitHub CLI がインストール済みでログイン していれば、gh attestation verify でビルドの出所も検証する
  • デフォルトで ~/.local/bin にインストール（対話式でインストール先を選択）
  • roji doctor --fix で環境をセットアップ
  • CA証明書をシステム信頼ストアにインストール
  • rojiをシステムサービスとして登録・起動

オプション

curl -fsSL ... | bash -s -- --global       # /usr/local/bin にインストール
curl -fsSL ... | bash -s -- --local        # ~/.local/bin にインストール（デフォルト）
curl -fsSL ... | bash -s -- --no-service   # サービス登録をスキップ
curl -fsSL ... | bash -s -- --upgrade      # アップグレード確認をスキップ
curl -fsSL ... | bash -s -- --version 1.2.0  # バージョンを指定してインストール（| ROJI_VERSION=1.2.0 bash でも可）

手動インストール

GitHub Releasesからダウンロード、またはソースからビルド：

git clone https://github.com/kan/roji.git && cd roji && make build
sudo ./bin/roji doctor --fix    # 環境セットアップ
sudo ./bin/roji ca install      # CA証明書インストール
sudo ./bin/roji service install && sudo ./bin/roji service start

ダウンロードしたアーカイブは、インストーラーと同じ方法でビルドの出所を検証できる。 GitHub CLI を使い、--source-ref にはダウンロードした版のタグを指定する。

gh attestation verify roji_Linux_x86_64.tar.gz --repo kan/roji \
  --signer-workflow kan/roji/.github/workflows/release-build.yml \
  --source-ref refs/tags/vX.Y.Z

--signer-workflow は、リリース用のワークフローがビルドしたアーカイブだけを 受け入れる指定。--source-ref は、その版のタグからビルドしたものだけを受け入れる指定。 v1.3.0 では --signer-workflow に kan/roji/.github/workflows/release.yml を指定する。 それより前の版に attestation は無い。

アップグレード

インストールスクリプトを再実行すると、既存のインストールを検出して自動アップグレードします：

curl --proto '=https' --tlsv1.2 -fsSL https://raw.githubusercontent.com/kan/roji/main/install.sh | bash

Homebrew の場合：

brew upgrade kan/roji/roji

インストール確認

roji version    # バージョン情報を表示
roji doctor     # 環境チェック

すべてのチェックがパスするはずです。問題がある場合は sudo roji doctor --fix で自動修復できます。

次のステップ

Edit this page on GitHub
Prev
CLIリファレンス
Next
よくある問題