You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/supported_docker_environment/windows.md
+13-8Lines changed: 13 additions & 8 deletions
Original file line number
Diff line number
Diff line change
@@ -4,26 +4,31 @@
4
4
*[Docker for Windows](https://docs.docker.com/docker-for-windows/) needs to be installed
5
5
* Docker version 17.06 is confirmed to work on Windows 10 with Hyper-V.
6
6
* Testcontainers supports communication with Docker on Docker for Windows using named pipes.
7
+
* WSL2 backend is supported starting with Windows 10 2004. (**Beta**)
7
8
8
9
## Limitations
9
10
The following features are not available or do not work correctly so make sure you do not use them or use them with
10
11
caution. The list may not be complete.
11
12
12
-
### Testing
13
-
14
-
Testcontainers is not regularly tested on Windows, so please consider it to be at an beta level of readiness.
15
-
16
-
If you wish to use Testcontainers on Windows, please confirm that it works correctly for you before investing significant
17
-
effort.
18
-
19
13
### MySQL containers
20
14
* MySQL server prevents custom configuration file (ini-script) from being loaded due to security measures ([link to feature description](../modules/databases/index.md#using-an-init-script-from-a-file))
21
15
22
16
### Windows Container on Windows (WCOW)
23
17
24
18
* WCOW is currently not supported, since Testcontainers uses auxiliary Linux containers for certain tasks and Docker for Windows does not support hybrid engine mode at the time of writing.
25
19
26
-
## Windows Subsystem for Linux
20
+
## WSL2 backend
21
+
22
+
Using Docker for Windows with WSL2 backend should work out of the box.
23
+
24
+
However, there is an [existing issue](https://github.com/microsoft/WSL/issues/4694) in WSL/WSL2 that effects certain older Docker images.
25
+
The currently proposed workaround is to enable vsyscall emulation in the WSL2 kernel:
26
+
```
27
+
[wsl2]
28
+
kernelCommandLine = vsyscall=emulate
29
+
```
30
+
31
+
## Windows Subsystem for Linux (WSL)
27
32
28
33
Testcontainers supports communicating with Docker for Windows within the Windows Subsystem for Linux *([**WSL**](https://docs.microsoft.com/en-us/windows/wsl/about))*.
29
34
The following additional configurations steps are required:
0 commit comments