トラブルシューティング

インストーラーがlibkrunが見つからないと表示する(macOS)

Homebrewでインストールしてから、インストーラーをもう一度実行します:

brew tap slp/krun && brew install slp/krun/libkrun slp/krun/libkrunfw zstd

/dev/kvmに書き込めない(Linux)

kumobadにはKVMが必要です。自分のユーザーをkvmグループに追加して、再ログインします:

sudo usermod -aG kvm "$USER"

クラウドのVMでは、インスタンスタイプがネストされた仮想化に対応しているか確認してください。

インストーラーがイメージを展開できない

ディスクの空き容量が不足しています。defaultイメージの展開には約2GB必要です。空き容量を確保してから、インストーラーをもう一度実行してください。途中まで書き込まれたファイルはインストーラーが削除します。

kumoba: Cannot reach kumobadと表示される

kumobadが起動していないか、CLIが別の場所を見ています。kumobadで起動してください。独自の設定でkumobadを動かしている場合は、KUMOBA_URLとKUMOBA_TOKENでCLIの接続先を指定します。この場合、CLIは終了ステータス3で終わります。

No kumobad tokenと表示される

kumobadは初回の起動時に~/.kumoba/tokenを作ります。一度起動するか、KUMOBA_TOKENを設定してください。

デスクトップのリンクが開かない、またはkumobadがpreview_listen_skippedを記録する

ポート7789を別のプログラムが使っているため、ブラウザ用のリンクを提供できません。ポートを空けるか、別のポートを指定します: KUMOBAD_PREVIEW_LISTEN=127.0.0.1:7790 kumobad。ポート7788が使われているときはlisten_skippedが記録されますが、CLIとSDKはソケット経由で動作し続けます。

stop the sandbox before changing its networkと表示される

ネットワークの設定は起動時に適用されます。kumoba stop <id>、kumoba update、kumoba start <id>の順に実行してください。

this sandbox's image has no shell supportと表示される

kumoba 0.3より前のイメージから作られたサンドボックスです。アップグレードしてから、新しいイメージでサンドボックスを作り直してください。

pip installがexternally-managed-environmentで失敗する

kumoba 0.2.2より前のイメージです。アップグレードすると、pip installをそのまま使えるイメージになります。

execで起動したサーバーがすぐに止まる

execは、コマンドが終わるとそのコマンドが起動したプロセスも止めます。動かし続けるプロセスはsetsidで起動してください。

それでも解決しない場合

kumobadのログ、kumoba versionの出力、OSとCPUを添えてIssueを作成してください。セキュリティの問題は公開せずに報告してください。