> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qumo-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# インストール

> スタンドアロンの qumod CLI バイナリを macOS、Linux、Windows にインストールします。

# `qumod` のインストール

`qumod` は、Qumo Deploy の公式コマンドラインインターフェース兼自動化ランタイムです。外部依存のない自己完結型のネイティブ実行ファイルとしてコンパイルされています（ホストに Node.js も Deno も必要ありません）。

## クイックインストール（推奨）

インストーラーは、お使いのプラットフォーム用のバイナリを `https://dl.qumo-deploy.com` からダウンロードし、リリースの `SHA256SUMS` と照合してから、ホームディレクトリにインストールします。`sudo` は不要です。

```bash macOS & Linux theme={null}
curl -fsSL https://dl.qumo-deploy.com/qumod/install.sh | sh
```

```powershell Windows (PowerShell) theme={null}
irm https://dl.qumo-deploy.com/qumod/install.ps1 | iex
```

* **macOS と Linux** では `~/.qumod/bin/qumod` にインストールされます。そのディレクトリが `PATH` にない場合、インストーラーがシェルのプロファイルに追加する行を表示します。
* **Windows** では `%LOCALAPPDATA%\qumod\bin\qumod.exe` にインストールされ、そのディレクトリがユーザーの `PATH` に追加されます。インストール後は新しいターミナルを開いてください。

バージョンの固定やインストール先の指定は、環境変数で行います。

```bash theme={null}
curl -fsSL https://dl.qumo-deploy.com/qumod/install.sh | QUMOD_VERSION=0.5.261029 QUMOD_INSTALL=/opt/qumod sh
```

CLI のバージョンはコントロールプレーンとは別に管理されています。最新のリリースは `https://dl.qumo-deploy.com/qumod/latest` で確認できます。

ダウンロードホストには最新の 10 リリースが保持されます。固定した古いバージョンは、それより新しいリリースが 9 つ出るとインストールできなくなるため、アップグレードの際は固定バージョンも更新してください。

***

## 手動ダウンロード

最新の 10 リリースはそれぞれ `https://dl.qumo-deploy.com/qumod/v<version>/` に公開されており、各バイナリのチェックサムを記載した `SHA256SUMS` ファイルも含まれます。

| プラットフォーム | アーキテクチャ | バイナリアセット |
| :- | :- | :- |
| **macOS** | Apple Silicon (M1/M2/M3) | `qumod-darwin-arm64` |
| **macOS** | Intel (x86\_64) | `qumod-darwin-amd64` |
| **Linux** | x86\_64 | `qumod-linux-amd64` |
| **Linux** | ARM64 (aarch64) | `qumod-linux-arm64` |
| **Windows** | x86\_64 | `qumod-windows-amd64.exe` |

たとえば Linux（x86\_64）では次のようにします。

```bash theme={null}
QUMOD_VERSION=0.5.261029
base="https://dl.qumo-deploy.com/qumod/v${QUMOD_VERSION}"
curl -fsSLO "${base}/qumod-linux-amd64"
curl -fsSL "${base}/SHA256SUMS" | grep ' qumod-linux-amd64$' | sha256sum -c -
install -m 0755 qumod-linux-amd64 ~/.local/bin/qumod
```

macOS では、`sha256sum -c -` の代わりに `shasum -a 256 -c -` を使ってください。

> [!NOTE]
>
> Linux バイナリは glibc 向けにビルドされています。Alpine などの musl ベースのイメージでは実行できないため、Debian または Ubuntu ベースのイメージを使ってください。

***

## インストールの確認

CLI が正しくインストールされ、実行できることを確認します。

```bash theme={null}
qumod version
```

期待される出力:

```text theme={null}
qumod version 0.5.261029 (darwin-aarch64)
```

JSON 出力形式も確認できます。

```bash theme={null}
qumod version --json
```

```json theme={null}
{"name":"qumod","version":"0.5.261029","deno":"2.9.4","v8":"15.0.245.2-rusty","typescript":"6.0.3","os":"darwin","arch":"aarch64"}
```

***

## 更新

インストーラーをもう一度実行します。バイナリがその場で最新リリースに置き換えられます。
`QUMOD_VERSION` を設定している場合は、そのバージョンに置き換えられます。

```bash macOS & Linux theme={null}
curl -fsSL https://dl.qumo-deploy.com/qumod/install.sh | sh
```

```powershell Windows (PowerShell) theme={null}
irm https://dl.qumo-deploy.com/qumod/install.ps1 | iex
```

現在のバージョンは `qumod version` で確認できます。

***

## アンインストール

インストールディレクトリを削除します。保存されたサインイン情報も消したい場合は、それも削除します。
コントロールプレーン上のセッションも終了するには、先に `qumod logout` を実行してください。

```bash macOS & Linux theme={null}
rm -rf ~/.qumod ~/.qumo
```

```powershell Windows (PowerShell) theme={null}
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\qumod", "$HOME\.qumo"
```

Windows では、ユーザーの `PATH` から `%LOCALAPPDATA%\qumod\bin` も削除してください
（**設定 → システム → バージョン情報 → システムの詳細設定 → 環境変数**）。
`QUMOD_INSTALL` を指定してインストールした場合は、代わりにそのディレクトリを削除してください。

***

## 次のステップ

サインインして、最初のコマンドを実行します。

```bash theme={null}
qumod login
qumod whoami
```

> [card] [認証ガイド](https://docs.qumo-deploy.com/cli/authentication.md)
>
> ブラウザのデバイスフローによる対話的な認証や、ヘッドレス環境向けの API トークンによる認証について説明します。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.