diff --git a/readme.md b/readme.md index 0a49b65..eb80be5 100644 --- a/readme.md +++ b/readme.md @@ -185,6 +185,25 @@ kubectl apply -f https://raw.githubusercontent.com/dockur/windows/refs/heads/mas CPU_CORES: "4" ``` +### How do I enable audio? + + Audio is disabled by default unless you are using RDP. To stream it to the browser, add the following environment variable: + + ```yaml + environment: + AUDIO: "Y" + ``` + + Then enable **Audio** under **Settings → Advanced** in the web viewer. The stream is only active while this option is enabled, so it uses no extra bandwidth otherwise. + +### How do I connect using RDP? + + The web viewer is mainly intended for use during installation, since it is less responsive than RDP and does not support features such as clipboard sharing. + + So for a better experience you can connect using any Microsoft Remote Desktop client to the IP of the container, using the username `Docker` and password `admin`. + + There is an RDP client for [Android](https://play.google.com/store/apps/details?id=com.microsoft.rdc.androidx) available from the Play Store and one for [iOS](https://apps.apple.com/nl/app/microsoft-remote-desktop/id714464092?l=en-GB) in the Apple Store. For Linux you can use [FreeRDP](https://www.freerdp.com/) and on Windows just type `mstsc` in the search box. + ### How do I configure the username and password? By default, a user called `Docker` is created and its password is `admin`. @@ -262,25 +281,6 @@ kubectl apply -f https://raw.githubusercontent.com/dockur/windows/refs/heads/mas MANUAL: "Y" ``` -### How do I connect using RDP? - - The web viewer is mainly intended for use during installation, since it is less responsive than RDP and does not support features such as clipboard sharing. - - So for a better experience you can connect using any Microsoft Remote Desktop client to the IP of the container, using the username `Docker` and password `admin`. - - There is an RDP client for [Android](https://play.google.com/store/apps/details?id=com.microsoft.rdc.androidx) available from the Play Store and one for [iOS](https://apps.apple.com/nl/app/microsoft-remote-desktop/id714464092?l=en-GB) in the Apple Store. For Linux you can use [FreeRDP](https://www.freerdp.com/) and on Windows just type `mstsc` in the search box. - -### How do I enable audio? - - Audio is disabled by default unless you are using RDP. To stream it to the browser, add the following environment variable: - - ```yaml - environment: - AUDIO: "Y" - ``` - - Then enable **Audio** under **Settings → Advanced** in the web viewer. The stream is only active while this option is enabled, so it uses no extra bandwidth otherwise. - ### How do I assign an individual IP address to the container? By default, the container uses bridge networking, which shares the IP address with the host. @@ -372,6 +372,12 @@ kubectl apply -f https://raw.githubusercontent.com/dockur/windows/refs/heads/mas > [!WARNING] > Adding a USB mass storage device before Windows Setup has finished may cause it to fail. Or worse: the drive can get formatted as the system disk, and all your data will be lost! So always keep them disconnected when launching the container for the first time. +### How do I enable dynamic memory allocation? + + By default, the VM is allocated the full amount of RAM configured via `RAM_SIZE` for its entire lifetime. + + However, you can enable [memory ballooning](https://github.com/qemus/qemu/docs/ballooning.md) if you want the container to dynamically reclaim unused guest RAM based on host memory pressure. + ### Are these all available options? No. For a complete overview of all supported settings, see the [environment variables](docs/environment.md) page.