Repository navigation
Usage
Reads KRYTON_URL (default http://localhost:8080), KRYTON_TOKEN and KRYTON_PROJECT (default default). Subcommands in cmd/krytonctl/main.go:
list, images, events, capabilities, doctor, storage, set-storage, get, start, stop, delete, snapshot, snapshots, restore, delete-snapshot, create, plus hash-token TOKEN and generate-token.
krytonctl create --image windows-server-2025 --cpu 4 --memory 8192 --disk 80 win01
krytonctl create --image ubuntu-24.04 --cpu 2 --memory 2048 --disk 20 \
--ssh-key ~/.ssh/id_ed25519.pub linux-dev
krytonctl doctorcreate flags (from source): --image (default windows-server-2025), --cpu (4), --memory MiB (8192), --disk GiB (80), --ssh-key, --username, --network, --ttl minutes, --project, and a family of --dockur-* flags (username, password, hostname, language, region, keyboard, product-key, domain, domain-ou, shared-dir, oem-dir, command, custom-iso, edition, extra-disks, audio, secure-boot, no-autologin). Machine name is the positional argument.
The README also shows --provider on scripts/deploy-remote.sh (not a krytonctl flag).
kryton-image list|validate|fetch|cdi|libvirt|cloud-init [flags]. Flags in source: --catalog, --image (default ubuntu-24.04), --dir (default /var/lib/kryton/images), --sha256, --url, --namespace (kryton-images), --storage-class, --name, --disk, --seed, --network.
bin/kryton-image list
bin/kryton-image fetch --image ubuntu-24.04 --dir /var/lib/kryton/images --sha256 "$APPROVED_SHA256"
bin/kryton-image cdi --image ubuntu-24.04 --namespace kryton-images --storage-class CLASS \
--url "https://artifacts.example/$APPROVED_SHA256.qcow2" > linux-cdi.jsonfetch requires an explicit approved SHA-256; Kryton does not trust a checksum fetched beside the image.
Discovery GET /api/v1; machines GET/POST /api/v1/machines (?limit= default 50, max 500, ?cursor=); events GET /api/v1/events and SSE GET /api/v1/events/stream; doctor GET /api/v1/doctor; console tickets POST /api/v1/machines/{id}/console-ticket. Full contract: docs/API.md and openapi.yaml.
curl -sS -H "Authorization: Bearer $KRYTON_TOKEN" "$KRYTON_URL/api/v1/machines?project=default"ubuntu-22.04/24.04/26.04, debian-12/13, rocky-9/10, almalinux-9/10, centos-stream-10, fedora-44 (amd64). Default users per image are listed in docs/LINUX-TEMPLATES.md; initialization.username overrides.
Kryton v1.3.0 - Apache-2.0 - Repository - Repo docs are authoritative.