How do I install the Kasm skill?

Run npx skillmds@latest add evolv3-ai/kasm in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Kasm?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

evolv3-ai (@evolv3-ai) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Kasm by evolv3-ai — Agent Skill

Name: Kasm
Rating: 4.2 (5 reviews)
Author: evolv3-ai

Kasm

Manage KASM Workspaces - a container-based VDI platform streaming desktops to browsers. Covers installation, workspace configuration, persistent profiles, S3 storage, backup/recovery, troubleshooting, and API operations for single-server and multi-server deployments. Use when: installing KASM, configuring workspaces, setting up persistent profiles, troubleshooting "No Resources Available", container destruction errors, backup to Backblaze B2, Cloudflare Tunnel setup, database operations, or managing KASM services.

evolv3-ai Updated Sep 10, 2026

File contents

KASM Workspaces

CRITICAL: Secrets and .env

NEVER store live .env files or credentials inside any skill folder.
.env.template files belong only in assets/ within a skill.
Store live secrets in ~/.admin/.env and reference from there.

Purpose: Install, configure, manage, and troubleshoot KASM Workspaces on Linux servers.

Step 0: Determine What the User Needs

Ask the user which task they need help with:

Task	Reference
Fresh installation	`references/installation.md`
Workspace configuration (profiles, volumes, Docker overrides)	`references/workspace-configuration.md`
Troubleshooting errors	`references/troubleshooting.md`
Backup and recovery	`references/backup-recovery.md`
Cloudflare Tunnel or reverse proxy	`references/networking.md`
Database queries or maintenance	`references/database-operations.md`
API calls or automation	`references/api-reference.md`
Service management (start/stop/logs)	`references/service-management.md`

Read the appropriate reference file and follow its instructions.

Quick Reference

System Requirements

Docker >= 25.0.5, Docker Compose >= 2.40.2
Minimum: 2 cores, 4GB RAM, 75GB SSD
Per session default: 2,768MB RAM + 2 cores
Swap partition strongly recommended
Supported: 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
Architectures: amd64 and arm64

Key Paths

Path	Purpose
`/opt/kasm/current/`	Installation root
`/opt/kasm/current/bin/start`	Start all services
`/opt/kasm/current/bin/stop`	Stop all services
`/opt/kasm/current/log/`	Log files (raw + JSON)
`/mnt/kasm_profiles/`	Persistent profiles (volume mount)
`/var/lib/docker`	Docker storage

Key Containers

Container	Role
`kasm_api`	API server
`kasm_agent`	Agent (runs workspace containers)
`kasm_manager`	Manager (orchestration)
`kasm_proxy`	HTTPS proxy
`kasm_db`	PostgreSQL database (user: kasmapp, db: kasm)

Service Control

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

Critical Rules

Always install Docker CE + Compose plugin BEFORE KASM.
Always configure swap - KASM can be unstable without it even with sufficient RAM.
Each concurrent session needs ~2-4GB RAM. Size the server accordingly.
Do not expose port 8443 publicly without HTTPS.
KASM API uses JSON payload auth (NOT HTTP Basic Auth). See references/api-reference.md.
The API calls workspaces "images" - get_images not get_workspaces.
For S3 persistent profiles, always include @endpoint in the path. Missing it causes excessive API calls.

Related Skills

devops for server inventory and provisioning
backblaze-b2 for S3-compatible storage
Provider skills (oci, hetzner, contabo, etc.) for server setup
cloudflare-worker-base for Cloudflare integrations

References

KASM docs: https://kasmweb.com/docs/latest/
KASM new docs: https://docs.kasm.com/
KASM GitHub issues: https://github.com/kasmtech/workspaces-issues
KASM Docker images: https://github.com/kasmtech

---name: kasmdescription: Manage KASM Workspaces - a container-based VDI platform streaming desktops to browsers. Covers installation, workspace configuration, persistent profiles, S3 storage, backup/recovery, troubleshooting, and API operations for single-server and multi-server deployments. Use when: installing KASM, configuring workspaces, setting up persistent profiles, troubleshooting "No Resources Available", container destruction errors, backup to Backblaze B2, Cloudflare Tunnel setup, database operations, or managing KASM services.license: MIT---# KASM Workspaces## CRITICAL: Secrets and .env- NEVER store live `.env` files or credentials inside any skill folder.- `.env.template` files belong only in `assets/` within a skill.- Store live secrets in `~/.admin/.env` and reference from there.**Purpose**: Install, configure, manage, and troubleshoot KASM Workspaces on Linux servers.## Step 0: Determine What the User NeedsAsk the user which task they need help with:| Task | Reference ||------|-----------|| Fresh installation | `references/installation.md` || Workspace configuration (profiles, volumes, Docker overrides) | `references/workspace-configuration.md` || Troubleshooting errors | `references/troubleshooting.md` || Backup and recovery | `references/backup-recovery.md` || Cloudflare Tunnel or reverse proxy | `references/networking.md` || Database queries or maintenance | `references/database-operations.md` || API calls or automation | `references/api-reference.md` || Service management (start/stop/logs) | `references/service-management.md` |Read the appropriate reference file and follow its instructions.---## Quick Reference### System Requirements- Docker >= 25.0.5, Docker Compose >= 2.40.2- Minimum: 2 cores, 4GB RAM, 75GB SSD- Per session default: 2,768MB RAM + 2 cores- Swap partition strongly recommended- Supported: 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- Architectures: amd64 and arm64### Key Paths| Path | Purpose ||------|---------|| `/opt/kasm/current/` | Installation root || `/opt/kasm/current/bin/start` | Start all services || `/opt/kasm/current/bin/stop` | Stop all services || `/opt/kasm/current/log/` | Log files (raw + JSON) || `/mnt/kasm_profiles/` | Persistent profiles (volume mount) || `/var/lib/docker` | Docker storage |### Key Containers| Container | Role ||-----------|------|| `kasm_api` | API server || `kasm_agent` | Agent (runs workspace containers) || `kasm_manager` | Manager (orchestration) || `kasm_proxy` | HTTPS proxy || `kasm_db` | PostgreSQL database (user: kasmapp, db: kasm) |### Service Control```bashsudo /opt/kasm/current/bin/stop # Stop allsudo /opt/kasm/current/bin/start # Start allsudo docker restart kasm_api # Restart single servicesudo docker logs -f kasm_api # Live logs```---## Critical Rules- Always install Docker CE + Compose plugin BEFORE KASM.- Always configure swap - KASM can be unstable without it even with sufficient RAM.- Each concurrent session needs ~2-4GB RAM. Size the server accordingly.- Do not expose port 8443 publicly without HTTPS.- KASM API uses JSON payload auth (NOT HTTP Basic Auth). See `references/api-reference.md`.- The API calls workspaces "images" - `get_images` not `get_workspaces`.- For S3 persistent profiles, always include `@endpoint` in the path. Missing it causes excessive API calls.## Related Skills- `devops` for server inventory and provisioning- `backblaze-b2` for S3-compatible storage- Provider skills (oci, hetzner, contabo, etc.) for server setup- `cloudflare-worker-base` for Cloudflare integrations## References- KASM docs: https://kasmweb.com/docs/latest/- KASM new docs: https://docs.kasm.com/- KASM GitHub issues: https://github.com/kasmtech/workspaces-issues- KASM Docker images: https://github.com/kasmtech

Frequently asked questions