Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Create troubleshooting_known_issues_with_docker_on_windows.md #157

Closed
wants to merge 2 commits into from
Closed
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions guides/docker_windows_troubleshooting.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
# Troubleshooting known issues with Docker on Windows
This guide will suggest possible solutions to known issues contributors might face when setting up Docker and VC Code on windows. The guide assumes that you have already followed the instructions ([here](https://github.com/creativecommons/search#readme))

## #1 Docker Desktop Stopped
This often occur immediately after fresh installations :

- Ensure you restart your system after installation

- Ensure you used the WSL 2 option on the Configuration page, only use Hper-V if you are very sure of you choice.

([Ensure WSL 2 is installed on your computer ](https://learn.microsoft.com/en-us/windows/wsl/install))
- Ensure you are running Docker as an administrator

- Ensure you restart you system after any of these processes

## #2 Configuration not found when running "docker compose build"
This error might occur when you trying to run the “`docker compose build“` outside your project folder :

- Navigate to the absolute path of your project using "CD" command then run the "docker compose build" command

## #3 Docker Desktop failed to start

- Uninstall Docker Desktop

- Restart computer

- Install Docker Desktop with Admin right