Docker container fails on Windows – missing sh and volume mounting issues in ArchGW 0.3.6

[yassirzarhouni]

Hi team

I was following the quickstart instructions in the docs for version 0.3.6, but ran into issues when running Docker commands on Windows.

The examples use Unix-style volume mounts and line continuations (e.g. ), which cause problems in Windows Command Prompt or PowerShell.

Environment

• OS: Windows 10
• ArchGW CLI: 0.3.6
• Docker: 25.x
• Docker Compose: 2.29+
• Python: 3.12 (venv active)

---

Error Output

docker: Error response from daemon: failed to create task for container:
failed to create shim task: OCI runtime create failed: runc create failed:
unable to start container process: exec: "sh": executable file not found in $PATH: unknown.

General infos :

docker run --rm katanemo/archgw:0.3.6 ls -la /bin
And it confirms that sh isn't available in the image, which seems to be the issue.
plus even when you try a workaround it still have a problem with mounting the needed files to the volume of the docker container.

[salmanap]

Thanks for reporting this. Couple of things a) can you please share the Windows OS you are running and b) can you try running archgw on Windows Subsystem for Linux (WSL) 2 and share if this built successfully. We've tested our work on WSL2 and we should be more precise about that.

If you can help us with those details, i'll start having a deeper look

[yassirzarhouni]

thanks for the reply!

I tested it on WSL2 (Ubuntu) and it works fine there no issues at all. But on native Windows 10 and 11, the problems persist.

From what I’ve checked, it looks like the main issue is the Docker image’s entrypoint using "sh", which isn’t available in the container. Also, when restarting the config (the second time i ran archgw up), SIGKILL doesn’t behave well on Windows, I had to add a check to switch it to SIGTERM for compatibility.

Hope that helps clarify things! Let me know if you need any other details.

[salmanap]

Makes sense. If you are open to contributing to the project we would love the help.