Hyperledger Fabric on WSL2 Ubuntu 22.04 LTS

Optimized for Windows 11/10 with WSL2 & Docker Desktop

This folder contains everything needed to run Hyperledger Fabric in a Windows environment using WSL2 (Windows Subsystem for Linux 2).

Key Difference: This setup is optimized for WSL2. If using pure Linux, some steps may differ.

Quick Start (5 Steps)

1. Install WSL2 & Ubuntu 22.04 → See SetupManual.md Part 1
2. Run the fixer script → bash setup-wsl.sh
3. Install Fabric → See SetupManual.md Part 3
4. Launch network → ./network.sh up createChannel -c mychannel -ca
5. Deploy chaincode → See SetupManual.md Part 5

Getting Started

To prepare your machine for Hyperledger Fabric, follow the comprehensive setup manual: SetupManual.md — Complete step-by-step guide (all parts)

Core Components

File	Focus	When to Use
setup-wsl.sh	WSL2 Fixer: Fixes Docker credential bugs, permissions, WSL2 network issues	Run this FIRST after part 2
SetupManual.md	Complete Guide: All 9 parts from prerequisites to troubleshooting	Reference this constantly
README.md	This file: Quick overview and component reference	Start here

Why This Repo?

WSL2 and Docker Desktop have unique challenges on Windows that don't exist on pure Linux:

• Docker credential manager conflicts → Fixed by setup-wsl.sh
• User permission issues → Automated in setup-wsl.sh
• Network timeouts and hangs → Addressed in SetupManual.md
• BuildKit incompatibilities → Documented in Docker config section

What Works?

Once properly configured, you can:

• Launch multi-container blockchain networks in WSL2
• Deploy chaincode successfully
• Query and invoke ledger transactions
• Use Docker Desktop's GUI alongside WSL2 terminal

Troubleshooting by Symptom

If You See...	Jump to...
docker: command not found	Part 8: WSL2-Specific Troubleshooting
./network.sh up hangs	WSL2 Network Issues
Build/permission errors	Clean Slate Reset

---

Ready? Open SetupManual.md and start with Part 0.