From 2cd84cf2d5459b04cedfcaf23bcd6b67567e32be Mon Sep 17 00:00:00 2001
From: ygd58 <buraysandro9@gmail.com>
Date: Sat, 6 Jun 2026 18:48:31 +0200
Subject: [PATCH] docs: add troubleshooting section to builder setup guide

- Add common setup errors with solutions
- Add ModuleNotFoundError, Docker, port conflict fixes
- Add Windows-specific activation command
- Add Getting Help section with Discord and GitHub links

Closes #400
---
 .../intelligent-contracts/tooling-setup.mdx   | 48 +++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/pages/developers/intelligent-contracts/tooling-setup.mdx b/pages/developers/intelligent-contracts/tooling-setup.mdx
index 3211c9fa..3c4e7529 100644
--- a/pages/developers/intelligent-contracts/tooling-setup.mdx
+++ b/pages/developers/intelligent-contracts/tooling-setup.mdx
@@ -383,3 +383,51 @@ const receipt = await client.waitForTransactionReceipt({
     status: "FINALIZED",
 });
 ```
+
+
+## Troubleshooting
+
+### Common Setup Errors
+
+#### ModuleNotFoundError: No module named genlayer
+
+Make sure you installed dependencies:
+
+```bash
+pip install -r requirements.txt
+```
+
+If using a virtual environment, activate it first:
+
+```bash
+source .venv/bin/activate  # Linux/macOS
+.venv\Scripts\activate     # Windows
+```
+
+#### Docker daemon is not running
+
+GenLayer Studio requires Docker. Start Docker Desktop and verify:
+
+```bash
+docker info
+```
+
+#### Port 4000 already in use
+
+```bash
+# Linux/macOS
+lsof -i :4000
+# Windows
+netstat -aon | findstr 4000
+```
+
+#### gltest command not found
+
+```bash
+pip install genlayer-test
+```
+
+### Getting Help
+
+- Discord: discord.gg/8Jm4v89VAu
+- GitHub Issues: github.com/genlayerlabs/genlayer-studio/issues