When new users run docker run … in the tutorial and Docker Desktop isn’t running, they just get cryptic errors.
Nobody has claimed this yet.
Assessment
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Newbie friendliness
- 55/100
- Issue type
- Feature
- Clarity
- Mostly clear
- Activity status
- Stale
- Tech stack
- bash, docker, powershell
- Domain
- devops, documentation
Research direction
Review the Docker tutorial step that runs docker run and the scripts/ folder first. Add Bash and PowerShell checks with helpful startup guidance, then mention both scripts in the tutorial and verify the messages when Docker is unavailable and available.
Written by the indexing model from the issue text.
Description
Add a small script (in Bash for Linux/macOS and PowerShell for Windows) that:
Checks if Docker is running
Prints a friendly message if it’s not
Suggests how to start it
Example (Bash):
bash
Copy
Edit
#!/bin/bash
if ! docker info > /dev/null 2>&1; then
echo "❌ Docker is not running."
echo "Please start Docker Desktop and try again."
exit 1
fi
echo "✅ Docker is running fine!"
This could live in a scripts/ folder and be mentioned in the tutorial.
- Dominant language
- JavaScript
- Stars
- 3.1k
- Forks
- 6.4k
- PR merge metrics
- No merged PRs in 30d
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from docker/getting-started
-
Difficulty 2/5 1-3 hours Newbie friendliness 68/100
docker/getting-started#481 · 2 comments · 5 reactions ·
-
Difficulty 1/5 1-3 hours Newbie friendliness 65/100
docker/getting-started#394 · 1 comment · 3 reactions ·
-
Difficulty 4/5 3-5 days Newbie friendliness 45/100
docker/getting-started#494 ·
-
Chat Open
Difficulty 5/5 Over a week Newbie friendliness 10/100
docker/getting-started#482 ·
-
Difficulty 1/5 Under an hour Newbie friendliness 1/100
docker/getting-started#477 ·
All issues in docker/getting-started
Similar issues
-
Bug
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
Automattic/safe-publish#594 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
dream-num/dsh-univer-office#104 ·
-
comp/dashboard invalid P3
Difficulty 2/5 1-3 hours Newbie friendliness 70/100
NousResearch/hermes-agent#121143 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 75/100
avniproject/avni-webapp#1811 ·
-
area/auroraboot area/webui bug
Difficulty 2/5 1-3 hours Newbie friendliness 75/100