Runpodctl

GPU ポッド、サーバーレスエンドポイント、テンプレート、ボリューム、モデルを管理します。

スペル: "Runpod"（大文字の R）。コマンドは runpodctl（小文字）です。

インストール

# すべてのプラットフォーム（公式インストーラー）
curl -sSL https://cli.runpod.net | bash

# macOS (Homebrew)
brew install runpod/runpodctl/runpodctl

# macOS (手動 — ユニバーサルバイナリ)
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-darwin-all.tar.gz | tar xz -C ~/.local/bin

# Linux
mkdir -p ~/.local/bin && curl -sL https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-linux-amd64.tar.gz | tar xz -C ~/.local/bin

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/runpod/runpodctl/releases/latest/download/runpodctl-windows-amd64.zip -OutFile runpodctl.zip; Expand-Archive runpodctl.zip -DestinationPath $env:LOCALAPPDATA\runpodctl; [Environment]::SetEnvironmentVariable('Path', $env:Path + ";$env:LOCALAPPDATA\runpodctl", 'User')

~/.local/bin が PATH に含まれていることを確認してください（~/.bashrc または ~/.zshrc に export PATH="$HOME/.local/bin:$PATH" を追加します）。

クイックスタート

runpodctl doctor                    # 初回セットアップ（API キー + SSH）
runpodctl gpu list                  # 利用可能な GPU を表示
runpodctl hub search vllm           # ハブリポジトリを検索
runpodctl serverless create --hub-id <id> --name "my-vllm"  # ハブからデプロイ
runpodctl template search pytorch   # テンプレートを検索
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"  # テンプレートから作成
runpodctl pod list                  # ポッドを一覧表示

API キー: https://runpod.io/console/user/settings

コマンド

ポッド

runpodctl pod list                                    # 実行中のポッドを一覧表示（デフォルト、docker ps のように）
runpodctl pod list --all                              # 終了したものを含むすべてのポッドを一覧表示
runpodctl pod list --status exited                    # ステータスでフィルタリング（RUNNING, EXITED など）
runpodctl pod list --since 24h                        # 過去 24 時間以内に作成されたポッド
runpodctl pod list --created-after 2025-01-15         # 指定日以降に作成されたポッド
runpodctl pod get <pod-id>                            # ポッドの詳細を取得（SSH 情報を含む）
runpodctl pod create --template-id runpod-torch-v21 --gpu-id "NVIDIA GeForce RTX 4090"  # テンプレートから作成
runpodctl pod create --image "runpod/pytorch:1.0.3-cu1281-torch291-ubuntu2404" --gpu-id "NVIDIA GeForce RTX 4090"  # イメージで作成
runpodctl pod create --compute-type cpu --image ubuntu:22.04  # CPU ポッドを作成
runpodctl pod start <pod-id>                          # 停止したポッドを起動
runpodctl pod stop <pod-id>                           # 実行中のポッドを停止
runpodctl pod restart <pod-id>                        # ポッドを再起動
runpodctl pod reset <pod-id>                          # ポッドをリセット
runpodctl pod update <pod-id> --name "new"            # ポッドを更新
runpodctl pod delete <pod-id>                         # ポッドを削除（エイリアス: rm, remove）

リストフラグ: --all / -a, --status, --since, --created-after, --name, --compute-type 取得フラグ: --include-machine, --include-network-volume

作成フラグ: --template-id（--image がない場合は必須）、--image（--template-id がない場合は必須）、--name、--gpu-id、--gpu-count、--compute-type、--ssh（デフォルト true）、--container-disk-in-gb、--volume-in-gb、--volume-mount-path、--network-volume-id、--ports、--env、--cloud-type、--data-center-ids、--global-networking、--public-ip

ハブ

Runpod ハブを参照して検索します — デプロイ可能なリポジトリの厳選されたマーケットプレイス。

runpodctl hub list                                    # スターが多い上位 10 件
runpodctl hub list --type SERVERLESS                  # サーバーレスリポジトリのみ
runpodctl hub list --type POD                         # ポッドリポジトリのみ
runpodctl hub list --category ai --limit 20           # カテゴリでフィルタリング
runpodctl hub list --order-by deploys                 # デプロイ数でソート
runpodctl hub list --owner runpod-workers             # リポジトリ所有者でフィルタリング
runpodctl hub search vllm                             # "vllm" を検索
runpodctl hub search whisper --type SERVERLESS        # サーバーレスリポジトリを検索
runpodctl hub get <listing-id>                        # リスティング ID で取得
runpodctl hub get runpod-workers/worker-vllm          # 所有者/名前で取得

リスト/検索フラグ: --type（POD, SERVERLESS）、--category、--order-by（stars, deploys, createdAt, updatedAt, releasedAt, views）、--order-dir（asc, desc）、--limit、--offset、--owner

サーバーレス（エイリアス: sls）

runpodctl serverless list                             # すべてのエンドポイントを一覧表示
runpodctl serverless get <endpoint-id>                # エンドポイントの詳細を取得
runpodctl serverless create --name "x" --template-id "tpl_abc"  # テンプレートから作成
runpodctl serverless create --name "x" --hub-id <listing-id>    # ハブリポジトリから作成
runpodctl serverless create --hub-id <id> --env MODEL_NAME=my-model  # ハブの環境デフォルトをオーバーライド
runpodctl serverless update <endpoint-id> --workers-max 5       # エンドポイントを更新
runpodctl serverless delete <endpoint-id>             # エンドポイントを削除

ハブから作成: --hub-id はハブリスティングを解決し、ビルドイメージと設定（GPU ID、コンテナディスク、環境変数）を抽出し、インラインテンプレートを作成してデプロイします。SERVERLESS と POD の両方のリスティングタイプを受け入れます。ハブ設定の GPU ID と環境変数のデフォルト値が自動的に含まれます。--gpu-id と --env でオーバーライドしてください。

リストフラグ: --include-template, --include-workers 更新フラグ: --name, --workers-min, --workers-max, --idle-timeout, --scaler-type（QUEUE_DELAY または REQUEST_COUNT）、--scaler-value 作成フラグ: --name、--template-id または --hub-id（いずれか必須）、--gpu-id、--gpu-count、--compute-type、--workers-min、--workers-max、--network-volume-id、--data-center-ids、--env

テンプレート（エイリアス: tpl）

runpodctl template list                               # 公式 + コミュニティ（最初の 10 件）
runpodctl template list --type official               # すべての公式テンプレート
runpodctl template list --type community              # コミュニティテンプレート（最初の 10 件）
runpodctl template list --type user                   # 自分のテンプレート
runpodctl template list --all                         # ユーザーテンプレートを含むすべて
runpodctl template list --limit 50                    # 50 個のテンプレートを表示
runpodctl template search pytorch                     # "pytorch" テンプレートを検索
runpodctl template search comfyui --limit 5           # 検索、結果を 5 件に限定
runpodctl template search vllm --type official        # 公式のみを検索
runpodctl template get <template-id>                  # テンプレートの詳細を取得（README、環境、ポートを含む）
runpodctl template create --name "x" --image "img"    # テンプレートを作成
runpodctl template create --name "x" --image "img" --serverless  # サーバーレステンプレートを作成
runpodctl template update <template-id> --name "new"  # テンプレートを更新
runpodctl template delete <template-id>               # テンプレートを削除

リストフラグ: --type（official, community, user）、--limit、--offset、--all 作成フラグ: --name、--image、--container-disk-in-gb、--volume-in-gb、--volume-mount-path、--ports、--env、--docker-start-cmd、--docker-entrypoint、--serverless、--readme

ネットワークボリューム（エイリアス: nv）

runpodctl network-volume list                         # すべてのボリュームを一覧表示
runpodctl network-volume get <volume-id>              # ボリュームの詳細を取得
runpodctl network-volume create --name "x" --size 100 --data-center-id "US-GA-1"  # ボリュームを作成
runpodctl network-volume update <volume-id> --name "new"  # ボリュームを更新
runpodctl network-volume delete <volume-id>           # ボリュームを削除

作成フラグ: --name, --size, --data-center-id

モデル

runpodctl model list                                  # あなたのモデルを一覧表示
runpodctl model list --all                            # すべてのモデルを一覧表示
runpodctl model list --name "llama"                   # 名前でフィルタリング
runpodctl model list --provider "meta"                # プロバイダーでフィルタリング
runpodctl model add --name "my-model" --model-path ./model  # モデルを追加
runpodctl model remove --name "my-model"              # モデルを削除

レジストリ（エイリアス: reg）

runpodctl registry list                               # レジストリ認証を一覧表示
runpodctl registry get <registry-id>                  # レジストリ認証を取得
runpodctl registry create --name "x" --username "u" --password "p"  # レジストリ認証を作成
runpodctl registry delete <registry-id>               # レジストリ認証を削除

情報

runpodctl user                                        # アカウント情報と残高（エイリアス: me）
runpodctl gpu list                                    # 利用可能な GPU を一覧表示
runpodctl gpu list --include-unavailable              # 利用不可の GPU を含める
runpodctl datacenter list                             # データセンターを一覧表示（エイリアス: dc）
runpodctl billing pods                                # ポッド課金履歴
runpodctl billing serverless                          # サーバーレス課金履歴
runpodctl billing network-volume                      # ボリューム課金履歴

SSH

runpodctl ssh info <pod-id>                           # SSH 情報を取得（コマンド + キー、接続しない）
runpodctl ssh list-keys                               # SSH キーを一覧表示
runpodctl ssh add-key                                 # SSH キーを追加

エージェント注: ssh info は接続の詳細を返し、インタラクティブセッションではありません。インタラクティブ SSH が利用できない場合は、ssh user@host "command" でコマンドをリモート実行してください。

ファイル転送

runpodctl send <path>                                 # ファイルを送信（コードを出力）
runpodctl receive <code>                              # コードを使用してファイルを受信

ユーティリティ

runpodctl doctor                                      # CLI の問題を診断して修正
runpodctl update                                      # CLI を更新
runpodctl version                                     # バージョンを表示
runpodctl completion                                  # シェルを自動検出してコンプリーション機能をインストール

URL

ポッド URL

ポッドで公開されているポートにアクセスします：

https://<pod-id>-<port>.proxy.runpod.net

例: https://abc123xyz-8888.proxy.runpod.net

サーバーレス URL

https://api.runpod.ai/v2/<endpoint-id>/run        # 非同期リクエスト
https://api.runpod.ai/v2/<endpoint-id>/runsync    # 同期リクエスト
https://api.runpod.ai/v2/<endpoint-id>/health     # ヘルスチェック
https://api.runpod.ai/v2/<endpoint-id>/status/<job-id>  # ジョブステータス