qemu-alpine-ssh

Set up SSH-enabled QEMU Alpine Linux virtual machines with port forwarding.

134|21|Updated Nov 12, 2025
One-click install
npx skills add https://github.com/letta-ai/skills --skill qemu-alpine-ssh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qemu-alpine-ssh
Source: https://github.com/letta-ai/skills/tree/main/ai/benchmarks/letta/terminal-bench-2/trajectory-feedback/qemu-alpine-ssh
Command: npx skills add https://github.com/letta-ai/skills --skill qemu-alpine-ssh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides procedural guidance for launching a QEMU VM with Alpine Linux and enabling SSH access, including port-forwarding, Alpine SSH setup, and troubleshooting.

Core Features & Use Cases

  • VM startup and network port-forward configuration
  • Alpine setup and OpenSSH server installation
  • SSH connectivity checks and troubleshooting guidance

Quick Start

Boot an Alpine-based QEMU VM with SSH port forwarding and connect from the host; verify SSH is operational.

Frequently Asked Questions about qemu-alpine-ssh

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

FAQPage Schema
How do I set up SSH access to a QEMU Alpine Linux virtual machine?

SSH access to QEMU Alpine requires three steps: configure host port forwarding when launching QEMU with `-net user,hostfwd=tcp::2222-:22`, install OpenSSH in Alpine using `apk add openssh`, and enable the SSH service with `rc-service sshd start`. Verify connectivity by connecting from the host via `ssh -p 2222 root@localhost`.

What port-forwarding syntax do I need for SSH on QEMU Alpine?

Use QEMU's hostfwd parameter: `-net user,hostfwd=tcp::<host_port>-:<guest_port>`. For SSH, map the host port (e.g., 2222) to Alpine's SSH port 22: `hostfwd=tcp::2222-:22`. This allows you to connect via `ssh -p <host_port> root@localhost`.

Can I troubleshoot SSH connectivity issues in QEMU Alpine environments?

Troubleshooting involves checking port availability on the host, verifying correct hostfwd syntax in your QEMU command, confirming OpenSSH is installed and running in Alpine, and testing connectivity with SSH client verbose mode. The Skill covers diagnostic workflows including QEMU command verification, Alpine tool checks, and optional automation scripts.

Do I need Alpine Linux to use SSH port forwarding with QEMU?

Alpine Linux is a lightweight, efficient choice for QEMU VMs with SSH, but port forwarding itself is a QEMU feature. This Skill specifically guides Alpine SSH setup; Alpine's minimal footprint makes it ideal for portable VMs, but SSH forwarding works with other guest operating systems.

What's the quickest way to boot a QEMU VM with Alpine and connect via SSH?

Boot Alpine ISO with QEMU and SSH port forwarding: `qemu-system-x86_64 -cdrom alpine.iso -net user,hostfwd=tcp::2222-:22`. Inside the VM, install and start SSH with `apk add openssh` and `rc-service sshd start`. Connect from the host with `ssh -p 2222 root@localhost`.

Why does SSH fail when I connect to my QEMU Alpine VM?

Common causes include the SSH service not running in Alpine, incorrect hostfwd syntax in your QEMU command, port conflicts on the host, or the Alpine SSH server not properly configured. Verify the service is active, check port availability, confirm your hostfwd parameter maps correctly, and test with verbose SSH output for detailed error messages.