Instead of reformatting USB for each new image, Ventoy lets you simply copy ISO files like regular files. At boot, you get a menu with all available images.
Benefits:
- โ No need to rewrite USB for each image
- โ Support for Windows, Linux, utilities - all on one drive
- โ Regular files accessible from any OS
- โ Flexible configuration via JSON
๐ Correct USB Structure
[First USB partition - exFAT/NTFS]
โโโ /ventoy/ # โ Must be here!
โ โโโ ventoy.json # Main config
โ โโโ revi/ # Windows auto-install
โ โ โโโ autounattend.xml
โ โโโ theme/ # Custom theme
โ โโโ distro/theme.txt
โ
โโโ BACKUP/ # Working files
โโโ LINUX/ # Linux ISOs
โ โโโ Archlinux 2025.12.01.iso
โ โโโ Debian 13.2.0.iso
โ โโโ NixOS 25.11.1734.iso
โโโ WINDOWS/ # Windows ISOs
โ โโโ Windows 10 22H2.iso
โ โโโ Windows 10 Enterprise LTSC 2021.iso
โ โโโ Windows 11 25H2.iso
โโโ ReviSetup/ # Post-install scripts
โ โโโ setup.cmd
โโโ UTILS/ # Utilities
โโโ gparted-live.iso
โโโ memtest86+.iso
โ ๏ธ Critical:
/ventoy/must be on the first partition (where ISOs are), NOT in root!
โ๏ธ Basic Configuration: ventoy.json
File must be at /ventoy/ventoy.json, UTF-8 encoding.
Minimal Example
{
"control": [
{ "VTOY_DEFAULT_MENU_MODE": "1" },
{ "VTOY_FILT_DOT_UNDERSCORE_FILE": "1" }
],
"theme": {
"file": "/ventoy/theme/distro/theme.txt",
"gfxmode": "1920x1080",
"resolution_fit": "1"
}
}
| Parameter | Description |
|---|---|
VTOY_DEFAULT_MENU_MODE | Default menu mode |
VTOY_FILT_DOT_UNDERSCORE_FILE | Hide files starting with . and _ |
theme.file | Path to GRUB theme file |
gfxmode | Menu resolution |
resolution_fit | Auto-fit to screen |
๐จ Customization: Menu Themes
Where to Get Themes
- distro-grub-themes - collection of ready-made themes
- Gnome-look.org - themes tagged
ventoy - Create your own - follow Ventoy documentation
Installing a Theme
# Clone theme
cd /mnt/ventoy/ventoy/theme
git clone https://github.com/AdisonCavani/distro-grub-themes.git distro
# Or download from Gnome-look
wget https://www.gnome-look.org/.../theme.tar.gz
tar xzf theme.tar.gz
In ventoy.json specify path:
{
"theme": {
"file": "/ventoy/theme/distro/theme.txt",
"resolution_fit": "1"
}
}
๐ช Windows Auto-Install
Structure for Auto-Install
/ventoy/
โโโ revi/
โโโ autounattend.xml # Windows Setup็ answers
/ReviSetup/
โโโ setup.cmd # Post-install
Example ventoy.json for Auto-Install
{
"auto_install": [
{
"parent": "/WINDOWS",
"template": ["/ventoy/revi/autounattend.xml"],
"autosel": 1
}
]
}
| Parameter | Value |
|---|---|
parent | Folder with Windows images |
template | Path to autounattend.xml |
autosel | Auto-select template |
What autounattend.xml Does
- Skips Microsoft account creation
- Disables telemetry
- Applies privacy settings
- Runs
setup.cmdafter install
๐ก Ready-made configs: meetrevision/ventoy-conf
๐ Post-Install: setup.cmd
Script runs automatically after Windows installation.
Example Actions
:: Disable driver updates
reg add "HKLM\Software\Policies\Microsoft\Windows\DriverSearching" /v "SearchOrderConfig" /t REG_DWORD /d 0 /f
:: Pause updates until 2038
reg add "HKLM\SOFTWARE\Microsoft\WindowsUpdate\UX\Settings" /v "PauseUpdatesExpiryTime" /t REG_SZ /d "2038-01-19T03:14:07Z" /f
:: Disable telemetry
reg add "HKLM\Software\Policies\Microsoft\Windows\DataCollection" /v "AllowTelemetry" /t REG_DWORD /d 0 /f
:: Prevent Teams auto-install
reg add "HKLM\SOFTWARE\Policies\Microsoft\Windows\Windows Chat" /v "ChatIcon" /t REG_DWORD /d 2 /f
๐ Checklist: Creating USB
- Installed Ventoy via
Ventoy2Disk.sh/.exe - Created
/ventoy/on first partition - Placed
ventoy.jsonin/ventoy/(UTF-8) - Copied images to logical folders (
LINUX/,WINDOWS/) - (Optional) Installed menu theme
- (Optional) Configured Windows auto-install
- Verified JSON syntax via json.cn
- Tested boot
๐ง Useful Commands
# Check ventoy.json syntax
cat /ventoy/ventoy.json | jq .
# In Ventoy menu: F5 - show ventoy.json content
# Recreate Ventoy partition (data will be lost!)
sudo ./Ventoy2Disk.sh -i /dev/sdX
๐ Additional Features
Ventoy supports many plugins and extensions:
- Persistence - save data between Live system reboots
- Memdisk - boot images into RAM
- Auto install - OS installation automation
- Custom menu - custom menu items
- Injection - inject drivers/files into images
๐ Documentation: ventoy.net
โ ๏ธ Common Issues
| Symptom | Solution |
|---|---|
ventoy.json not applied | Check path: strictly /ventoy/ventoy.json |
| Theme not loading | Check encoding (UTF-8) and path in config |
| Auto-install not working | Ensure parent points to correct folder |
| JSON parse error | Check syntax via online validator |
๐ Security
- โ exFAT - accessible from any OS (but unencrypted)
- ๐ For sensitive files: VeraCrypt container
- โ
autounattend.xmlandsetup.cmd- plain text, no passwords
๐ Links
- ๐ Official Ventoy Site
- ๐จ Theme Collection
- ๐จ Themes on Gnome-look
- ๐ช Windows Auto-Install
- ๐ Plugin Documentation