Yeast v0.1.0 test tutorial.

What this proves

• Yeast installs on a real Linux host.
• The host has QEMU/KVM, SSH, Git, Go, and ISO tooling ready.
• A project can be initialized with `yeast.yaml`.
• Ubuntu 24.04 can be pulled and verified.
• A QEMU/KVM VM can boot and become reachable by SSH.
• The VM can stop, start again, and be destroyed cleanly.

Before you start

Use a Linux machine with virtualization enabled and internet access.

ls -l /dev/kvm

If `/dev/kvm` does not exist, enable virtualization in BIOS/UEFI or install your distro's KVM/QEMU packages.

1. Install Yeast v0.1.0

Copy this exact command from the landing page:

curl -fsSL https://raw.githubusercontent.com/Twarga/yeast/v0.1.0/install.sh | YEAST_REF=v0.1.0 bash

If the installer adds your user to a KVM group, log out and log back in before continuing. A reboot is also fine.

2. Verify install

which yeast
yeast version
yeast doctor

Expected version: `v0.1.0`.

3. Create a clean test project

mkdir -p ~/yeast-v010-test
cd ~/yeast-v010-test
ls -la
yeast init
cat yeast.yaml

Expected: a `yeast.yaml` file with one `web` instance using `ubuntu-24.04`.

4. Pull the Ubuntu image

yeast pull --list
yeast pull ubuntu-24.04

Expected: Ubuntu 24.04 downloads or reuses the cache, then checksum verification succeeds.

5. Start and inspect the VM

yeast up
yeast status
yeast status --json

Expected: `web` becomes running. The JSON output should be valid JSON with no terminal styling.

6. SSH into the VM

yeast ssh web
hostname
whoami
uname -a
ip addr
exit

Expected: SSH opens without manually typing the forwarded port.

7. Stop, start again, then destroy

yeast down
yeast status
yeast up
yeast status
yeast destroy
yeast status

Expected: `down` stops the VM without deleting the disk. `up` starts it again. `destroy` removes project runtime files.

8. Confirm cache remains

find ~/.yeast/cache -maxdepth 3 -type f | head

Expected: shared cached image files still exist.

9. Test clear errors

yeast ssh missing-vm
yeast pull does-not-exist

Expected: clear errors, no crash.

10. Final report

Send or save this report after testing:

Yeast v0.1.0 manual test

Host:
Distro:
Kernel:
CPU:

Install: pass/fail
Doctor: pass/fail
Init: pass/fail
Pull: pass/fail
Up: pass/fail
Status: pass/fail
Status JSON: pass/fail
SSH: pass/fail
Down: pass/fail
Up again: pass/fail
Destroy: pass/fail
Cache preserved: pass/fail
Error handling: pass/fail

Notes:

If something fails

Save the exact command, full output, distro, and KVM status.

cat /etc/os-release
uname -a
groups
ls -l /dev/kvm
yeast version
yeast doctor
yeast status --json
ps aux | grep qemu
find ~/.yeast -maxdepth 4 -type f | sort