docker-qemu-reactos/README.md

41 lines
1006 B
Markdown
Raw Normal View History

2019-02-20 22:10:38 +00:00
# ReactOS on Docker
A Docker image for the [ReactOS](https://www.reactos.org) operating system.
## Start an instance
```sh
docker run --detach \
--name qemu-reactos \
2021-11-02 18:16:38 +00:00
--device /dev/kvm \
2021-11-02 18:17:57 +00:00
--publish 127.0.0.1:5900:5900/tcp \
2019-02-20 22:10:38 +00:00
--publish 127.0.0.1:6080:6080/tcp \
2021-02-11 20:20:03 +00:00
docker.io/hectormolinero/qemu-reactos:latest
2019-02-20 22:10:38 +00:00
```
> The instance can be accessed from:
2021-11-02 18:17:57 +00:00
> * VNC (5900/TCP): any VNC client, without credentials.
> * noVNC (6080/TCP): http://127.0.0.1:6080/vnc.html
2019-02-20 22:10:38 +00:00
## Environment variables
#### `VM_CPU`
2019-02-20 22:10:38 +00:00
Number of cores the VM is permitted to use (`2` by default).
#### `VM_RAM`
2019-02-20 22:10:38 +00:00
Amount of memory the VM is permitted to use (`1024M` by default).
#### `VM_DISK_SIZE`
2019-02-20 22:10:38 +00:00
VM disk size (`16G` by default).
#### `VM_KEYBOARD`
2019-02-20 22:10:38 +00:00
VM keyboard layout (`en-us` by default).
#### `VM_BOOT_ORDER`
2019-03-07 20:50:38 +00:00
VM boot order (`cd` by default).
#### `VM_KVM`
2021-11-02 18:16:38 +00:00
Start QEMU in KVM mode (`true` by default).
> The `--device /dev/kvm` option is required for this variable to take effect.
2019-02-20 22:10:38 +00:00
## License
See the [license](LICENSE.md) file.