https://github.com/slonopotamus/docker-wsl-proxy

🚢 docker-wsl-proxy allows connecting from Windows to Docker running in WSL2
https://github.com/slonopotamus/docker-wsl-proxy

containers docker windows wsl wsl2

Last synced: 22 days ago
JSON representation

🚢 docker-wsl-proxy allows connecting from Windows to Docker running in WSL2

• Host: GitHub
• URL: https://github.com/slonopotamus/docker-wsl-proxy
• Owner: slonopotamus
• License: apache-2.0
• Archived: true
• Created: 2022-01-21T18:41:04.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2023-02-19T22:03:16.000Z (over 1 year ago)
• Last Synced: 2024-07-30T21:04:30.053Z (4 months ago)
• Topics: containers, docker, windows, wsl, wsl2
• Language: Go
• Homepage:
• Size: 481 KB
• Stars: 8
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.adoc
  • Changelog: CHANGELOG.adoc
  • License: LICENSE

Awesome Lists containing this project

README

        
= docker-wsl-proxy

Marat Radchenko

:slug: slonopotamus/docker-wsl-proxy

:uri-project: https://github.com/{slug}

:uri-ci: {uri-project}/actions?query=branch%3Amain

image:{uri-project}/workflows/CI/badge.svg?branch=main[Build Status,link={uri-ci}]

image:https://img.shields.io/github/release/{slug}.svg[Download,link={uri-project}/releases/latest]

**This repo is deprecated. docker-wsl-proxy was a helper binary for Stevedore WSL2 support. Other tools like Rancher Desktop have their own similar implementations.**

== Overview

docker-wsl-proxy allows connecting from Windows to Docker running in WSL2.

There are several important aspects of this task:

- Tunnelling Docker API calls _into_ WSL2

- Conversion of Windows paths to their WSL equivalents

== Usage

. Install `socat` in WSL2

. Run `dockerd` inside WSL2

. Run `docker-wsl-proxy.exe -c wsl:///var/run/docker.sock`

. Run Docker commands on Windows host

== Building from source

. https://go.dev/doc/install[Install Go]

. Clone docker-wsl-proxy Git repository

. Run `go build` in repository root

. Now you have ready-to-use `docker-wsl-proxy.exe`

You can also use `go run docker-wsl-proxy.go` to build & run in one step.