[PR #132] [MERGED] docs: Windows support proposal (WSL2 + Hyper-V, Docker-Desktop-style install) #132

New issue

Closed

opened 2026-10-15 12:52:14 +00:00 by bsakaguchi · 0 comments

bsakaguchi commented

2026-10-15 12:52:14 +00:00

Owner

📋 Pull Request Information

Original PR: https://github.com/games-on-whales/LXC2Docker/pull/132
Author: @JBailes
Created: 7/1/2026
Status: ✅ Merged
Merged: 7/1/2026
Merged by: @JBailes

Base: main ← Head: docs/windows-support-proposal

📝 Commits (1)

1764ce7 docs: propose Windows support (WSL2 + Hyper-V) with a Docker-Desktop-style install

📊 Changes

1 file changed (+584 additions, -0 deletions)

View changed files

➕ docs/proposals/windows-support.md (+584 -0)

📄 Description

What

Adds docs/proposals/windows-support.md — an all-in design proposal for running the Linux docker-lxc-daemon on Windows.

The daemon is Linux-only (LXC + ~20 host tools + ZFS/PVE), so Windows support means the Docker Desktop model: run the engine inside a managed Linux VM and bridge the Windows Docker socket into it. This proposal commits to both backends and the install UX:

WSL2 (default; Windows Home) and Hyper-V (full-fidelity appliance with a ZFS data disk).
A signed installer + system-tray control app, docker/compose/build on the Windows CLI via an isolated DOCKER_CONFIG, and clean coexistence with an existing Docker Desktop.

Scope covered

Socket bridge + transports (stdio relay / hvsock / loopback), a per-backend security/trust model (pipe SDDL, channel token auth, WSL2-is-not-a-security-boundary), Windows-path volumes, published-port reachability, build, an honest capability matrix, a spike-gated phased rollout, CI/testing, packaging + mandatory signing, ongoing maintenance cost, measurable phase-annotated success criteria, and explicit non-goals (WCOW, streaming, Kubernetes, arm64 Hyper-V).

Process

Docs-only. Refined through two roundtable review passes (five seats on the full draft, three on the Hyper-V + installer designs); each blocking/major finding and its resolution is recorded in the proposal's review log (§16).

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/games-on-whales/LXC2Docker/pull/132 **Author:** [@JBailes](https://github.com/JBailes) **Created:** 7/1/2026 **Status:** ✅ Merged **Merged:** 7/1/2026 **Merged by:** [@JBailes](https://github.com/JBailes) **Base:** `main` ← **Head:** `docs/windows-support-proposal` --- ### 📝 Commits (1) - [`1764ce7`](https://github.com/games-on-whales/LXC2Docker/commit/1764ce75fa7a4395fa7ed3e78edf8493bf9f8bf3) docs: propose Windows support (WSL2 + Hyper-V) with a Docker-Desktop-style install ### 📊 Changes **1 file changed** (+584 additions, -0 deletions) <details> <summary>View changed files</summary> ➕ `docs/proposals/windows-support.md` (+584 -0) </details> ### 📄 Description ## What Adds `docs/proposals/windows-support.md` — an all-in design proposal for running the Linux `docker-lxc-daemon` on Windows. The daemon is Linux-only (LXC + ~20 host tools + ZFS/PVE), so Windows support means the Docker Desktop model: run the engine inside a managed Linux VM and bridge the Windows Docker socket into it. This proposal commits to **both** backends and the install UX: - **WSL2** (default; Windows Home) and **Hyper-V** (full-fidelity appliance with a ZFS data disk). - A **signed installer + system-tray control app**, `docker`/`compose`/`build` on the Windows CLI via an isolated `DOCKER_CONFIG`, and clean coexistence with an existing Docker Desktop. ## Scope covered Socket bridge + transports (stdio relay / hvsock / loopback), a per-backend security/trust model (pipe SDDL, channel token auth, WSL2-is-not-a-security-boundary), Windows-path volumes, published-port reachability, build, an honest capability matrix, a spike-gated phased rollout, CI/testing, packaging + mandatory signing, ongoing maintenance cost, measurable phase-annotated success criteria, and explicit non-goals (WCOW, streaming, Kubernetes, arm64 Hyper-V). ## Process Docs-only. Refined through two roundtable review passes (five seats on the full draft, three on the Hyper-V + installer designs); each blocking/major finding and its resolution is recorded in the proposal's review log (§16). --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>

bsakaguchi

2026-10-15 12:52:14 +00:00

closed this issue
added the
pull-request
label

No labels

pull-request

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

games-on-whales/LXC2Docker#132

No description provided.

Rows
Columns