mirror of
https://github.com/dockur/windows.git
synced 2026-07-15 01:38:16 +01:00
docs: Readme (#1848)
This commit is contained in:
@@ -185,6 +185,25 @@ kubectl apply -f https://raw.githubusercontent.com/dockur/windows/refs/heads/mas
|
|||||||
CPU_CORES: "4"
|
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?
|
### How do I configure the username and password?
|
||||||
|
|
||||||
By default, a user called `Docker` is created and its password is `admin`.
|
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"
|
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?
|
### 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.
|
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]
|
> [!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.
|
> 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?
|
### Are these all available options?
|
||||||
|
|
||||||
No. For a complete overview of all supported settings, see the [environment variables](docs/environment.md) page.
|
No. For a complete overview of all supported settings, see the [environment variables](docs/environment.md) page.
|
||||||
|
|||||||
Reference in New Issue
Block a user