Skip to content

Commit d093e4f

Browse files
authored
docs: KVM troubleshooting (#218)
1 parent 3a5d10d commit d093e4f

File tree

1 file changed

+9
-5
lines changed

1 file changed

+9
-5
lines changed

readme.md

+9-5
Original file line numberDiff line numberDiff line change
@@ -340,24 +340,28 @@ The example folder `/home/user/example` will be available as ` \\host.lan\Data`.
340340

341341
### How do I verify if my system supports KVM?
342342

343-
To verify that your system supports KVM, run the following commands:
343+
Only Linux and Windows 11 support KVM virtualization, macOS and Windows 10 do not unfortunately.
344+
345+
You can run the following commands in Linux to check your system:
344346

345347
```bash
346348
sudo apt install cpu-checker
347349
sudo kvm-ok
348350
```
349351

350-
If you receive an error from `kvm-ok` indicating that KVM acceleration can't be used, please check whether:
352+
If you receive an error from `kvm-ok` indicating that KVM cannot be used, please check whether:
351353

352354
- the virtualization extensions (`Intel VT-x` or `AMD SVM`) are enabled in your BIOS.
353355

354-
- you are running an operating system that supports them, like Linux or Windows 11 (macOS and Windows 10 do not unfortunately).
355-
356356
- you enabled "nested virtualization" if you are running the container inside a virtual machine.
357357

358358
- you are not using a cloud provider, as most of them do not allow nested virtualization for their VPS's.
359359

360-
If you didn't receive any error from `kvm-ok` at all, but the container still complains that `/dev/kvm` is missing, it might help to add `privileged: true` to your compose file (or `--privileged` to your `run` command), to rule out any permission issue.
360+
If you do not receive any error from `kvm-ok` but the container still complains about KVM, please check whether:
361+
362+
- you are not using "Docker Desktop for Linux" as it does not support KVM, instead make use of Docker Engine directly.
363+
364+
- it could help to add `privileged: true` to your compose file (or `sudo` to your `run` command), to rule out any permission issue.
361365

362366
### Is this project legal?
363367

0 commit comments

Comments
 (0)