Skip to content

docs(docs): improve Docker daemon troubleshooting for all platforms#24907

Closed
bpmct wants to merge 2 commits into
mainfrom
ben/devrel-23-docker-socket-troubleshooting
Closed

docs(docs): improve Docker daemon troubleshooting for all platforms#24907
bpmct wants to merge 2 commits into
mainfrom
ben/devrel-23-docker-socket-troubleshooting

Conversation

@bpmct
Copy link
Copy Markdown
Member

@bpmct bpmct commented May 1, 2026

Improves the Docker daemon troubleshooting in the quickstart and Docker install docs:

  • Renames the quickstart entry from "Cannot connect to the Docker daemon on Linux" to cover all platforms.
  • Adds a plain-English explanation of what the error means (Docker is not installed or not running).
  • Adds tabbed macOS/Linux/Windows instructions to the quickstart (macOS and Windows were missing).
  • Simplifies the Linux steps to match what Step 1 of the quickstart already teaches.
  • Adds a matching entry to docs/install/docker.md with a cross-link to the quickstart for platform-specific steps.

Fixes https://linear.app/codercom/issue/DEVREL-23

Generated with Coder Agents

@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 1, 2026

Docs preview

📖 View docs preview for docs/tutorials/quickstart.md

@bpmct bpmct changed the title docs(docs/tutorials): improve Docker daemon troubleshooting for all platforms docs(docs): improve Docker daemon troubleshooting for all platforms May 1, 2026
Comment thread docs/install/docker.md
```

Docker is not installed or not running on the host. Install Docker and start the
daemon before creating a workspace from a Docker-based template. See the
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
daemon before creating a workspace from a Docker-based template. See the
daemon before creating a workspace from a Docker-based template. Refer to the

Personal style nit, if we ever have users of our docs who rely on screen readers, the word "see" could come off as abrasive.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good call, fixed in 85f1ce1.

@bpmct bpmct closed this May 1, 2026
@github-actions github-actions Bot locked and limited conversation to collaborators May 1, 2026
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants