bootc

# Bootc - bootc-based VM Management

## Overview

The `bootc` command manages bootable container VMs using bcvk (bootc virtualization kit). It converts OCI container images into bootable VMs for testing.

**Key Concept:** Unlike traditional VMs, bootc VMs are created directly from container images. This enables testing bootable containers without building disk images first.

## Quick Reference

| Action | Command | Description |
|--------|---------|-------------|
| Add | `ujust bootc add [NAME]` | Create persistent VM with disk |
| Delete | `ujust bootc delete [NAME]` | Delete VM and its disk |
| Export | `ujust bootc export [IMAGE] [FORMAT]` | Export container as qcow2/raw image |
| Images | `ujust bootc images` | List available bootc images |
| List | `ujust bootc list` | List all bootc VMs |
| Prereqs | `ujust bootc prereqs` | Verify bcvk and dependencies installed |
| SSH | `ujust bootc ssh [NAME]` | SSH connection to VM |
| Start | `ujust bootc start [NAME]` | Start persistent VM |
| Status | `ujust bootc status [NAME]` | Show VM status and info |
| Stop | `ujust bootc stop [NAME]` | Stop running VM |

## Prerequisites

```bash
# Install bcvk
ujust install bcvk

# Verify installation
bcvk --version
```

## Parameters

| Parameter | Long Flag | Short | Default | Description |
|-----------|-----------|-------|---------|-------------|
| action | (positional) | - | required | Action: add, list, status, ssh, etc. |
| vm_name | (positional) | - | `bazzite-bootc` | VM name |
| image | `--image` | `-i` | (varies) | Container image to boot |
| cpus | `--cpus` | - | `2` | Number of CPUs |
| ram | `--ram` | - | `4096` | Memory in MB |
| disk_size | `--disk-size` | - | `20G` | Disk size |
| format | `--format` | `-f` | `qcow2` | Export format (qcow2, raw) |
| ssh_port | `--ssh-port` | - | `2222` | SSH port |
| ssh_user | `--ssh-user` | - | `root` | SSH user |

## Ephemeral Testing

Quick test that auto-deletes VM on exit:

```bash
# Test default bazzite-ai image
ujust test