Skip to content

docs: add WSL2 troubleshooting guide to README #733

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.

Sign up for GitHub

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

Open
shahedalhunity754 wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: add WSL2 troubleshooting guide to README #733

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7fd1bcd
docs: add WSL2 troubleshooting guide to README
shahedalhunity754 Apr 23, 2026
a214cbf
docs: refine WSL2 guide based on maintainer feedback
shahedalhunity754 May 1, 2026
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
8 changes: 8 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -65,6 +65,14 @@ Note: If you install Fablo as a local script, you call it as `./fablo <command>`
If you install it globally, you call `fablo <command>`.
For the simplicity we will refer to it as `fablo`.

###Troubleshooting for WSL2 & Ubuntu Users
If you are running Fablo on **Windows Subsystem for Linux (WSL2)**, you may encounter environment-specific issues. Here are the recommended fixes:

* **Docker V2 Syntax:** Ensure you use `docker compose` (with a space) instead of `docker-compose`.
Comment thread
shahedalhunity754 marked this conversation as resolved.
* **Socket Permissions: **If you get a "permission denied" error, run:

@umegbewe umegbewe Apr 27, 2026

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.

It would be good to confirm the exact scenario where this was required, did you experience this error?

`sudo chmod 666 /var/run/docker.sock`

* **WSL2 Integration:** Confirm that "WSL2 Integration" is enabled in Docker Desktop settings for your specific Ubuntu distribution.

## Basic usage

Expand Down
Loading