skills.rest
bianhaifeng789-hue
bianhaifeng789-hueCOMMUNITY
Explore all skills by this author →
GitHub

qemu-startup

Start headless QEMU VMs with telnet serial console access.

Updated Apr 14, 2026
Search Tags:#qemu#telnet#virtualization#process-management#kvm#boot-verification#serial-console
One-click install
npx skills add https://github.com/bianhaifeng789-hue/openclaw-config --skill qemu-startup-bianhaifeng789-hue
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: qemu-startup
Source: https://github.com/bianhaifeng789-hue/openclaw-config/tree/main/skills/tb2/qemu-startup
Command: npx skills add https://github.com/bianhaifeng789-hue/openclaw-config --skill qemu-startup-bianhaifeng789-hue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a clear, repeatable approach to launching headless QEMU virtual machines with accessible serial consoles, avoiding common failures like KVM misconfiguration, port conflicts, backgrounded processes surviving shells, and unreliable boot checks.

Core Features & Use Cases

  • Environment checks: Detects available tools and verifies KVM and required image files before attempting startup.
  • Console and port handling: Recommends non-blocking telnet-backed serial configuration and pre-start port validation to prevent "address already in use" errors.
  • Process and boot management: Describes methods to locate, terminate, and document QEMU processes, and to poll the serial console for boot readiness instead of relying on arbitrary sleeps.
  • Use Case: Start a headless test VM for OS installation or automated testing where remote telnet access to the serial console and deterministic startup/teardown are required.

Quick Start

Start a headless QEMU VM from /path/to/image.iso with serial redirected to a telnet port, verify KVM and port availability, and return the VM PID and connection instructions.

Frequently Asked Questions about qemu-startup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a headless QEMU virtual machine with telnet serial console access?▼

To start a headless QEMU VM, configure the serial console to use a non-blocking telnet port, verify KVM availability, and launch the process in the background. This returns the VM PID and telnet connection instructions for remote access.

Why does my QEMU virtual machine fail to start with an address already in use error?▼

QEMU fails with an address already in use error when the configured telnet serial port is occupied. Pre-start port validation checks port availability before launching the VM, preventing port conflicts and ensuring the serial console binds successfully.

How do I verify QEMU boot readiness without using arbitrary sleep delays?▼

Verify QEMU boot readiness by polling the serial console output for specific boot completion signals. This polling-based verification replaces arbitrary sleeps, deterministically confirming the headless VM is fully booted and ready for testing.

What is the best way to locate and terminate lingering QEMU background processes?▼

The best way to manage lingering QEMU processes is using process identification and termination strategies. By locating the specific VM PID documented at startup, you can deterministically terminate the correct virtual machine process and avoid orphaned instances.

Can I use KVM acceleration for my QEMU virtual machine if hardware virtualization is available?▼

Yes, you can use KVM acceleration when hardware virtualization is available. The startup process includes automatic KVM detection to verify your environment supports it, ensuring the QEMU virtual machine launches with optimal performance.

How do I check if my environment is ready to run a QEMU virtual machine?▼

Check environment readiness for a QEMU VM by detecting available tools, verifying KVM support, and confirming required image files exist. These pre-start environment checks prevent common startup failures related to missing dependencies or misconfiguration.

Related Skills

Explore More Software Engineering Skills→
Heyo-ComputerHeyo-Computer

heyvm-system

Validate host system readiness for Heyo VM sandboxes across Linux and macOS.

Official
Advanced
lazyFrogLOLlazyFrogLOL
127

qemu-startup

Start QEMU VMs with serial console and boot verification.

Community
Advanced
ZurybrZurybr

qemu-startup

Start QEMU virtual machines with telnet serial consoles and verify boot.

Community
Intermediate
DustinTrapDustinTrap
2

kvm-pilot

Manage KVM devices and detect boot phases via remote console.

Community
Advanced