# Ozone

## Docs

- [Ozone: QEMU VM Management Library for Go](https://mintlify.wiki/stratosphere-ve/ozone/introduction.md): Ozone provides Go packages for managing QEMU virtual machines — start/stop lifecycle, JSON config parsing, and strongly-typed resource accessors for CPU, memory, network, and disk.
- [Get Started with Ozone in Go](https://mintlify.wiki/stratosphere-ve/ozone/quickstart.md): Learn how to install Ozone, define your first VM configuration file, and start a QEMU virtual machine in a few steps.
- [VM Configuration File Structure and Schema in Ozone](https://mintlify.wiki/stratosphere-ve/ozone/vm-config/overview.md): Ozone stores each virtual machine as a JSON file in vms/. Learn how configs are structured and how the vmparser package maps them to typed Go structs.
- [Ozone VM Configuration JSON Schema Field Reference](https://mintlify.wiki/stratosphere-ve/ozone/vm-config/schema.md): Complete JSON field reference for Ozone VM config files. Covers all VMInfo, CPU, Memory, Network, and Disk fields with Go types and JSON keys.
- [How to Read VM Configuration Files in Ozone vmparser](https://mintlify.wiki/stratosphere-ve/ozone/vm-config/reading.md): Learn how to use vmparser reader functions to load typed VM config structs from disk, from full VM objects down to individual field getter functions.
- [How to Write VM Configuration Files in Ozone vmparser](https://mintlify.wiki/stratosphere-ve/ozone/vm-config/writing.md): Learn how to use vmparser writer functions to update VM config sections on disk without overwriting unrelated fields using the read-merge-write pattern.
- [Launch a QEMU Virtual Machine with Ozone's qemu.Start()](https://mintlify.wiki/stratosphere-ve/ozone/qemu/start.md): The qemu.Start() function prompts for a VM name, loads its config via vmparser, and launches qemu-system-x86_64 with q35 machine type and QMP over TCP.
- [Stop a Running QEMU Virtual Machine with Ozone's qemu.Stop()](https://mintlify.wiki/stratosphere-ve/ozone/qemu/stop.md): The qemu.Stop() function runs system_powerdown as a local executable to initiate a VM shutdown sequence and captures its output for error reporting.
- [vmparser Package — Ozone VM Config API](https://mintlify.wiki/stratosphere-ve/ozone/api-reference/vmparser.md): Complete API reference for the vmparser package: types, parser functions, getter shortcuts, and writer functions for Ozone VM configuration files.
- [qemu Package — QEMU Lifecycle API Reference](https://mintlify.wiki/stratosphere-ve/ozone/api-reference/qemu.md): API reference for the qemu package: Start() and Stop() functions for managing QEMU virtual machine lifecycle in Ozone.