Skip to content

docs(container): say that WSL shuts an idle distro down, and how to stop it - #103

Merged
youdie006 merged 1 commit into
container/redesign-patchesfrom
docs/wsl-idle-timeout
Nov 10, 2026
Merged

youdie006 merged 1 commit into
container/redesign-patchesfrom
docs/wsl-idle-timeout

Conversation

@youdie006

Copy link
Copy Markdown
Owner

What changed

The WSL bullet under "Keep the Docker engine running" in docs/container-browser.md only said that WSL starts when something on Windows starts it. It left out the part that kept the browser container down after a Windows restart: WSL shuts an idle distro down 15 s after its last wsl.exe ends (instanceIdleTimeout, default 15000 ms per Microsoft's wsl-config page). Docker and the container stop with it.

The bullet now gives the setting that turns this off, [general] instanceIdleTimeout=-1 in %UserProfile%\.wslconfig, and says it takes effect the next time WSL starts. There is also a CHANGELOG line.

Evidence (WSL host, read from logs on 2026-11-10, no restart made)

Sources: the Windows System log, pm2's log, systemd and Docker. Times are KST, 2026-10-28.

Time Event
21:35:44 Windows logon
21:36:54 Distro started by a Startup-folder wsl.exe -d Ubuntu -u ... -- true
21:37:12 Distro shut down, 18 s after it started
21:37:24 Distro started again
21:37:42 Distro shut down again
21:46:42 Distro started and stayed up; a terminal was opened

Whenever the distro did start, docker and the unless-stopped containers came back within about 3 s.

Not verified

  • The setting was added to the host's .wslconfig on 2026-11-10. It has not yet been observed across a Windows restart.
  • This is a docs-only change, with no code or test changes.

…top it

docs/container-browser.md said WSL starts when something on Windows starts
it. It did not say that WSL then shuts an idle distro down 15 s after its
last wsl.exe ends (`instanceIdleTimeout`), docker and the browser container
with it.

Found 2026-11-10 from the WSL host's logs: the Windows System log, pm2's log,
systemd and Docker. After the 2026-10-28 restart a logon shortcut running
`wsl.exe ... -- true` started the distro twice. It shut down 18 s later each
time, and the container stayed down until a terminal was opened 11 minutes
after logon. The doc now gives `[general] instanceIdleTimeout=-1` for
%UserProfile%\.wslconfig, per Microsoft's wsl-config page.

The setting was added to that host's .wslconfig the same day. It takes
effect when WSL next starts, and has not been observed across a restart yet.

Claude-Session: https://claude.ai/code/session_01EMqNwnnhHXznd2P2PDsaDV
@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Nov 10, 2026 •

Copy link
Copy Markdown
Codex Review Summary: ✅ Completed

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-11-10T07:44:53.606993Z 27467df PR opened
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@github-actions

Copy link
Copy Markdown

What this touches

  • (nothing recognised)

2 file(s), 25 line(s) changed. Tests unchanged.

This is an automated first pass, not a review. CI is the gate; a person decides.

@youdie006
youdie006 merged commit 41bebbe into container/redesign-patches Nov 10, 2026
7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant