kasm

KASM Workspaces

重大：シークレットと .env

• 有効な .env ファイルや認証情報をスキルフォルダー内に絶対に保存しないでください。
• .env.template ファイルは、スキル内の assets/ にのみ配置してください。
• 有効なシークレットは ~/.admin/.env に保存し、そこを参照してください。

目的：Linux サーバー上で KASM Workspaces をインストール、設定、管理し、トラブルシューティングを行います。

ステップ 0：ユーザーのニーズを確認する

どのタスクについてサポートが必要か、ユーザーに尋ねてください。

タスク	参照先
新規インストール	references/installation.md
ワークスペースの設定（プロファイル、ボリューム、Docker のオーバーライド）	references/workspace-configuration.md
エラーのトラブルシューティング	references/troubleshooting.md
バックアップと復旧	references/backup-recovery.md
Cloudflare Tunnel またはリバースプロキシ	references/networking.md
データベースのクエリまたはメンテナンス	references/database-operations.md
API 呼び出しまたは自動化	references/api-reference.md
サービス管理（起動／停止／ログ）	references/service-management.md

該当するリファレンスファイルを読み、その指示に従ってください。

---

クイックリファレンス

システム要件

• Docker >= 25.0.5、Docker Compose >= 2.40.2
• 最低要件：2 コア、4GB RAM、75GB SSD
• セッションあたりのデフォルト：2,768MB RAM + 2 コア
• スワップパーティションを強く推奨
• 対応 OS：Ubuntu 22.04/24.04、Debian 11/12、RHEL 8/9/10、Oracle Linux 8/9、AlmaLinux/Rocky 8/9、Raspberry Pi OS 11/12
• アーキテクチャ：amd64 および arm64

主なパス

パス	用途
/opt/kasm/current/	インストールルート
/opt/kasm/current/bin/start	すべてのサービスを起動
/opt/kasm/current/bin/stop	すべてのサービスを停止
/opt/kasm/current/log/	ログファイル（生データ + JSON）
/mnt/kasm_profiles/	永続プロファイル（ボリュームマウント）
/var/lib/docker	Docker ストレージ

主なコンテナ

コンテナ	役割
kasm_api	API サーバー
kasm_agent	エージェント（ワークスペースコンテナを実行）
kasm_manager	マネージャー（オーケストレーション）
kasm_proxy	HTTPS プロキシ
kasm_db	PostgreSQL データベース（ユーザー：kasmapp、DB：kasm）

サービス制御

sudo /opt/kasm/current/bin/stop     # Stop all
sudo /opt/kasm/current/bin/start    # Start all
sudo docker restart kasm_api        # Restart single service
sudo docker logs -f kasm_api        # Live logs

---

重要なルール

• KASM の前に、必ず Docker CE と Compose プラグインをインストールしてください。
• 十分な RAM があっても、KASM はスワップなしでは不安定になる可能性があるため、必ずスワップを設定してください。
• 同時実行セッションごとに約 2～4GB の RAM が必要です。それに応じてサーバーの容量を決めてください。
• HTTPS を使用せずにポート 8443 を公開しないでください。
• KASM API は JSON ペイロード認証を使用します（HTTP Basic Auth は使用しません）。references/api-reference.md を参照してください。
• API ではワークスペースを「イメージ」と呼びます。get_workspaces ではなく get_images を使用してください。
• S3 の永続プロファイルでは、必ずパスに @endpoint を含めてください。省略すると API 呼び出しが過剰に発生します。

関連スキル

• サーバーのインベントリとプロビジョニングには devops
• S3 互換ストレージには backblaze-b2
• サーバーのセットアップにはプロバイダースキル（oci、hetzner、contabo など）
• Cloudflare との連携には cloudflare-worker-base

参考資料

• KASM ドキュメント：https://kasmweb.com/docs/latest/
• KASM 新ドキュメント：https://docs.kasm.com/
• KASM GitHub イシュー：https://github.com/kasmtech/workspaces-issues
• KASM Docker イメージ：https://github.com/kasmtech