sonic-ventoy

sonic-ventoy is the maintained Sonic boot-media entry point for the free uDOS release. It provides the Ventoy-compatible templates, menu policy, boot-drive layout guidance, and startup configuration used to build curated Sonic boot sticks for older machines, recovery kits, and profile-aware installer media.

What This Repo Owns

• Ventoy plugin templates and GRUB extension assets
• Sonic modern and retro boot theme baselines
• Profile-aware boot metadata and image menu conventions
• Partition-layout defaults and generated stick structure guidance
• The handoff consumed by sonic-screwdriver during stick initialization

What This Repo Does Not Own

• Upstream Ventoy core internals
• Runtime semantics or application behavior after install
• Canonical OS payload ownership in uDOS-ubuntu
• Device apply orchestration owned by sonic-screwdriver

Repo Structure

• docs/ reference docs for ownership, architecture, activation, and examples
• wiki/ short operator-facing orientation pages
• learning/ guided learning notes for contributors and students
• @dev/ repo-local development coordination surface
• templates/ventoy/ boot templates copied onto generated media
• profiles/ boot-profile manifests
• config/ partition-layout and media defaults
• scripts/ local validation utilities
• tests/ validation notes
• examples/ example outputs and reference layouts

Family Relation

sonic-ventoy is maintained separately from the former uDOS-family collection, but it remains part of the wider public uDOS documentation flow. Broad family guidance should continue to route through the GitHub Pages family library index, while this repository stays focused on the Sonic-owned boot and installer/distributor lane.

Public family docs:

• repo: https://github.com/fredporter/uDOS-docs/
• Pages index: https://fredporter.github.io/uDOS-docs/

License And Legal

This repository is intended for the free public uDOS release under Apache 2.0. See LICENSE, LEGAL.md, DISCLAIMER.md, TERMS.md, and ABOUT.md.

Validation

Run the local validation entry point with:

./scripts/run-ventoy-checks.sh