Skip to content

chore: let QEMU choose the disk I/O backend unless DISK_IO is set #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
vaggeliskls merged 1 commit into from
Oct 7, 2026
Merged

chore: let QEMU choose the disk I/O backend unless DISK_IO is set #8

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions .env.example
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,8 +59,9 @@ VERSION=2022
RAM_SIZE=8G
CPU_CORES=4
DISK_SIZE=100G
# QEMU disk I/O backend: native (default, works on any kernel), threads, or
# io_uring (faster, needs kernel 5.12 or newer; older kernels fail at boot).
# QEMU disk I/O backend: native, threads or io_uring. Empty lets QEMU choose,
# which is io_uring on recent kernels. Kernels before 5.12 (Ubuntu 20.04) fail
# at boot with "Failed to initialize io_uring": set native there.
# DISK_IO=native
# Local administrator created by the unattended install; also the RDP login
WIN_USERNAME=admin
Expand Down
2 changes: 1 addition & 1 deletion README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ Two authentication methods are supported. Set **one** of them in `.env`:
| `INSTALL_RTOOLS` | `true` | Install Rtools 4.0 with `mingw-w64-x86_64-make` |
| `VERSION` | `2022` | dockur Windows release (`2022` = Windows Server 2022 evaluation) |
| `RAM_SIZE` / `CPU_CORES` / `DISK_SIZE` | `8G` / `4` / `100G` | VM size |
| `DISK_IO` | `native` | QEMU disk I/O backend. `io_uring` is faster but needs kernel 5.12 or newer; on older kernels QEMU exits at boot with `Failed to initialize io_uring` |
| `DISK_IO` | QEMU's choice | QEMU disk I/O backend: `native`, `threads` or `io_uring`. Kernels before 5.12 exit at boot with `Failed to initialize io_uring`; set `native` there |
| `WIN_USERNAME` / `WIN_PASSWORD` | `admin` / `runner` | Local administrator created by the install, also the RDP login |

2. Start it and follow the container side (ISO download, QEMU boot):
Expand Down
6 changes: 3 additions & 3 deletions docker-compose.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,9 +17,9 @@ services:
RAM_SIZE: "${RAM_SIZE:-8G}"
CPU_CORES: "${CPU_CORES:-4}"
DISK_SIZE: "${DISK_SIZE:-100G}"
# QEMU disk I/O backend. dockur picks io_uring, which fails on kernels
# before 5.12 with "Failed to initialize io_uring: Cannot allocate memory".
DISK_IO: "${DISK_IO:-native}"
# QEMU disk I/O backend; empty lets QEMU choose. Set DISK_IO=native in .env
# on kernels before 5.12 ("Failed to initialize io_uring" at boot).
DISK_IO: "${DISK_IO:-}"
USERNAME: "${WIN_USERNAME:-admin}"
PASSWORD: "${WIN_PASSWORD:-runner}"
devices:
Expand Down
Loading