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 \
|
2022-04-26 20:11:31 +00:00
|
|
|
docker.io/hectorm/qemu-reactos:latest
|
2019-02-20 22:10:38 +00:00
|
|
|
```
|
2021-10-31 12:07:59 +00:00
|
|
|
|
2021-11-11 21:54:22 +00:00
|
|
|
The instance can be accessed from:
|
|
|
|
|
* **VNC (5900/TCP):** any VNC client, without credentials.
|
|
|
|
|
* **noVNC (6080/TCP):** http://127.0.0.1:6080/vnc.html
|
|
|
|
|
* **Shell:** `docker exec -it qemu-reactos vmshell`
|
2019-02-20 22:10:38 +00:00
|
|
|
|
|
|
|
|
## Environment variables
|
2021-10-31 12:07:59 +00:00
|
|
|
#### `VM_CPU`
|
2019-02-20 22:10:38 +00:00
|
|
|
Number of cores the VM is permitted to use (`2` by default).
|
|
|
|
|
|
2021-10-31 12:07:59 +00:00
|
|
|
#### `VM_RAM`
|
2019-02-20 22:10:38 +00:00
|
|
|
Amount of memory the VM is permitted to use (`1024M` by default).
|
|
|
|
|
|
2021-10-31 12:07:59 +00:00
|
|
|
#### `VM_KEYBOARD`
|
2019-02-20 22:10:38 +00:00
|
|
|
VM keyboard layout (`en-us` by default).
|
|
|
|
|
|
2021-10-31 12:07:59 +00:00
|
|
|
#### `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.
|
