skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
evolv3-ai/vibe-skills57 installs

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.

How do I install this agent skill?

npx skills add https://github.com/evolv3-ai/vibe-skills --skill kasm
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides comprehensive instructions for installing, configuring, and managing KASM Workspaces. It documents standard administrative procedures including service management, database maintenance, and backup configurations. While it includes instructions for tasks involving elevated privileges and external software downloads, all resources originate from official or trusted sources, and the operations are consistent with the primary purpose of managing a server-based VDI platform.

  • Socketwarn

    4 alerts: gptSecurity, gptAnomaly

  • Snykpass

    Risk: LOW · No issues

What does this agent skill do?

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:

TaskReference
Fresh installationreferences/installation.md
Workspace configuration (profiles, volumes, Docker overrides)references/workspace-configuration.md
Troubleshooting errorsreferences/troubleshooting.md
Backup and recoveryreferences/backup-recovery.md
Cloudflare Tunnel or reverse proxyreferences/networking.md
Database queries or maintenancereferences/database-operations.md
API calls or automationreferences/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

PathPurpose
/opt/kasm/current/Installation root
/opt/kasm/current/bin/startStart all services
/opt/kasm/current/bin/stopStop all services
/opt/kasm/current/log/Log files (raw + JSON)
/mnt/kasm_profiles/Persistent profiles (volume mount)
/var/lib/dockerDocker storage

Key Containers

ContainerRole
kasm_apiAPI server
kasm_agentAgent (runs workspace containers)
kasm_managerManager (orchestration)
kasm_proxyHTTPS proxy
kasm_dbPostgreSQL 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

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/evolv3-ai/vibe-skills/kasm">View kasm on skillZs</a>