kasm

Name: kasm
Author: evolv3-ai

github.com/evolv3-aiCloud & DevOps141 installsUpdated 14w ago

About kasm

kasm is a skill for installing, configuring, managing, and troubleshooting KASM Workspaces on Linux servers. It directs tasks to focused guidance for areas such as networking, backups, and API automation.

Key features

01Installation and service management
02Workspace and profile configuration
03Troubleshooting guidance
04Backup and recovery procedures
05Networking and API operations

Use cases

01Installing KASM Workspaces on a Linux server
02Configuring workspace profiles and volumes
03Investigating service errors and logs
04Automating tasks through the API

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/evolv3-ai/vibe-skills --skill kasm

After installing, type/kasmin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/

env-template

references/

api-reference.md

backup-recovery.md

cloudflare-tunnel.md

database-operations.md

installation.md

networking.md

service-management.md

troubleshooting.md

workspace-configuration.md

Details

From the project README

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

Comments

Markdown supported

Details

Author: evolv3-ai
Repository: evolv3-ai/vibe-skills
Category: Cloud & DevOps
Installs: 41
GitHub stars: 1

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.