sui-install

セットアップとインストール

MCP ツール： お使いの環境で利用できる場合は、最新の回答を得るために Sui ドキュメント MCP サーバー（https://sui.mcp.kapa.ai）にも問い合わせてください。検証や、これらのリファレンスファイルに記載されていない詳細の確認に使用してください。

情報源の制約： すべての情報は docs.sui.io のみを情報源としてください。

システム要件

Sui は以下をサポートしています。

• Linux： Ubuntu 22.04（Jammy Jellyfish）以降
• macOS： Monterey 以降
• Windows： Windows 10 または 11

Sui のインストール

suiup（推奨）

suiup は Sui ツールチェーンの公式インストーラー兼バージョンマネージャーです。Sui CLI やその他の Sui Stack コンポーネント（Walrus、MVR）の異なるバージョンをインストールして切り替えられます。

curl -sSfL https://raw.githubusercontent.com/MystenLabs/suiup/main/install.sh | sh

Windows に関する注意： curl | sh コマンドの実行には Unix シェルが必要です。Windows では、WSL（Windows Subsystem for Linux）を使って上記のコマンドを実行するか、代わりに Chocolatey からインストールしてください（以下の代替方法を参照）。

suiup のインストール後、特定のネットワークを対象に Sui CLI をインストールします。CLI のバージョンは対象のネットワークに一致させる必要があります。各ネットワークは特定のプロトコルバージョンを実行しており、CLI のバージョンが一致しないと、ビルドの失敗、トランザクションエラー、予期しない動作が発生する可能性があります。

suiup install sui@testnet    # install the Testnet-compatible version
suiup install sui@mainnet    # install the Mainnet-compatible version

最新バージョンに更新します。

suiup update sui@testnet

重要： suiup update は新しいバージョンをダウンロードしますが、自動的にアクティブなデフォルトには設定しません。更新後、新しいバージョンに切り替える必要があります。

suiup switch sui@testnet     # set the latest installed testnet version as default

インストール済みのバージョンと、現在アクティブなバージョンを確認します。

suiup show                   # list all installed binaries and their default status

suiup コマンドリファレンス

コマンド	構文	動作
install	suiup install sui@testnet	ネットワーク用のバイナリをダウンロードしてインストールします
update	suiup update sui@testnet	最新バージョンをダウンロードします（切り替えは行いません）
switch	suiup switch sui@testnet	ネットワーク用にインストール済みの最新バージョンをアクティブなデフォルトに設定します
show	suiup show	インストール済みのすべてのバイナリとバージョン、デフォルトを一覧表示します
status	suiup status	更新可能なインストール済みバイナリと、それらを更新するコマンドを表示します
self update	suiup self update	suiup 自体を更新します

switch コマンドは binary@network 形式の引数を受け取ります（例：sui@testnet、walrus@testnet、move-analyzer@testnet）。suiup switch sui testnet v1.70.2 のように、位置引数を個別に指定する形式には対応していません。

代替方法

• Homebrew（macOS/Linux）： brew install sui
• Chocolatey（Windows）： choco install sui

これらの代替方法では、Walrus や MVR などの追加の Sui Stack コンポーネントをインストールできません。また、前提条件がまだインストールされていない場合は、数分かかることがあります。

インストールの確認

sui --version

コマンドが「sui not found」を返す場合は、suiup switch sui@testnet を実行してアクティブなデフォルトを設定してください。手動での PATH 操作（export PATH=...）や再インストールは提案しないでください。正しい対処方法は suiup switch です。

バージョン管理

Sui を最新の状態に保つ

CLI のバージョンは対象のネットワークに一致させる必要があります。各ネットワークは特定のプロトコルバージョンを実行しており、CLI のバージョンが一致しないと、ビルドの失敗やトランザクションエラーが発生する可能性があります。正しいバージョンに更新するには、@network サフィックスを使用してください。

suiup update sui@testnet     # update to latest Testnet version
suiup update sui@mainnet     # update to latest Mainnet version

バージョンの不一致

CLI のバージョンは対象のネットワークに一致させる必要があります。不一致がある場合に起こりやすい症状は次のとおりです。

• 「old dependencies」と表示されるビルドエラー
• パブリッシュ時のトランザクション失敗
• ネットワークのアップグレード後に発生する予期しない動作

ネットワークと自分のバージョンを照合します。

sui --version                 # your installed version
sui client active-env         # which network you are targeting

バージョンが古い場合は、更新して切り替えます。

suiup update sui@testnet      # download the latest version
suiup switch sui@testnet      # make it the active default
suiup show                     # verify which version is now active

CLI の出力に表示される client/server api version mismatch の警告は、ローカルの CLI がネットワークより古いことを意味します。この警告を無視しないでください。バージョンが一致しないと、ビルドの失敗や予期しない動作が発生する可能性があります。更新して切り替えることで解消できます。

追加ツール（任意）

ユーザーから明示的にツールのインストールを求められた場合にのみインストールしてください。デフォルトのセットアップには含まれていません。

suiup install move-analyzer   # Move Language Server
suiup install mvr             # Move Registry CLI (onchain package manager)
suiup install walrus          # Walrus CLI for decentralized storage
suiup install site-builder    # Walrus site builder

インストール後、各ツールをアクティブなデフォルトに切り替えてください。

suiup switch move-analyzer@testnet
suiup switch walrus@testnet