From 12a2b1f22c44b53c87ed214839b445da2cc88331 Mon Sep 17 00:00:00 2001
From: varvaraklimova102 <141798984+varvaraklimova102@users.noreply.github.com>
Date: Thu, 28 Aug 2025 13:39:32 +0100
Subject: [PATCH 1/3] Create troubleshooting.md

Add comprehensive troubleshooting guide for common issues
---
 troubleshooting.md | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)
 create mode 100644 troubleshooting.md

diff --git a/troubleshooting.md b/troubleshooting.md
new file mode 100644
index 0000000..015d39e
--- /dev/null
+++ b/troubleshooting.md
@@ -0,0 +1,32 @@
+# 🔧 Troubleshooting Common Issues
+
+## Node Setup Problems
+
+### "Illegal instruction (core dumped)" Error
+
+Problem: Your CPU doesn't support modern AVX instructions.
+Solution: Install WasmEdge no-AVX version:
+curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install_v2.sh | bash -s -- -v 0.13.5 --noavx
+Then restart your GaiaNet node:
+bashgaianet stop
+gaianet start
+Port Already in Use
+
+Problem: Port 8080 is already occupied.
+Solution: Check what's using the port:
+bashsudo netstat -tulpn | grep :8080
+Kill the process or use a different port in your config.
+Memory Issues
+
+Problem: Node crashes with out of memory errors.
+Solution: Ensure you meet minimum requirements:
+4GB RAM minimum (8GB recommended)
+10GB free disk space
+RAG-Related Issues
+Node Responds to General Queries but Not Specific Ones
+
+Problem: RAG database retrieval issues with domain-specific questions.
+Solution:
+Check your snapshot was properly imported
+Review logs: ~/gaianet/log/start-llamaedge.log
+Verify your knowledge base was correctly processed

From 610ad9c9b98bd85b1d7d15d2dd565d12c36c198b Mon Sep 17 00:00:00 2001
From: varvaraklimova102 <141798984+varvaraklimova102@users.noreply.github.com>
Date: Fri, 29 Aug 2025 10:56:47 +0100
Subject: [PATCH 2/3] docs: add prerequisites and troubleshooting to
 installation guide

---
 README.md | 49 ++++++++++++++++++++++++++++++++++++++++---------
 1 file changed, 40 insertions(+), 9 deletions(-)

diff --git a/README.md b/README.md
index 0385c4b..04b0690 100644
--- a/README.md
+++ b/README.md
@@ -20,15 +20,46 @@ Gaia is a decentralized AI infrastructure that empowers everyone to build, scale
 
 After forking and cloning the repository:
 
-1. Install dependencies:
-   ```
-   npm install
-   ```
-2. Start the development server:
-   ```
-   npm start
-   ```
-3. Open your browser and visit `http://localhost:3000`
+## 📋 Prerequisites
+
+**System Requirements:**
+- Node.js 16.0 or higher
+- npm 7.0 or higher  
+- Git
+
+**Check your versions:**
+```
+node --version
+npm --version
+```
+## 🚀 Installation
+
+### Step 1: Clone and Setup
+```
+git clone https://github.com/YOUR-USERNAME/docs.git
+cd docs
+npm install
+```
+
+### Step 2: Start Development Server
+```
+npm start
+```
+
+### Step 3: View Documentation
+Open your browser and visit `http://localhost:3000`
+
+### 🔧 Troubleshooting
+
+Port 3000 already in use?
+```
+npm start -- --port 3001
+```
+Installation fails?
+```
+rm -rf node_modules package-lock.json
+npm install
+```
 
 ## Structure
 

From fe91e43189498d2115da0c14d166046b1006a1e8 Mon Sep 17 00:00:00 2001
From: varvaraklimova102 <141798984+varvaraklimova102@users.noreply.github.com>
Date: Thu, 4 Sep 2025 13:07:35 +0100
Subject: [PATCH 3/3] Update troubleshooting.md

---
 .../troubleshooting/troubleshooting.md        | 29 +++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/docs/getting-started/troubleshooting/troubleshooting.md b/docs/getting-started/troubleshooting/troubleshooting.md
index e11d470..f6f35d6 100644
--- a/docs/getting-started/troubleshooting/troubleshooting.md
+++ b/docs/getting-started/troubleshooting/troubleshooting.md
@@ -183,5 +183,34 @@ curl -sSfL 'https://github.com/GaiaNet-AI/gaianet-node/releases/latest/download/
 
 This problem is fixed in `version 0.2.3`.
 
+## Node Setup Problems
 
+### "Illegal instruction (core dumped)" Error
+
+Problem: Your CPU doesn't support modern AVX instructions.
+Solution: Install WasmEdge no-AVX version:
+curl -sSf https://raw.githubusercontent.com/WasmEdge/WasmEdge/master/utils/install_v2.sh | bash -s -- -v 0.13.5 --noavx
+Then restart your GaiaNet node:
+bashgaianet stop
+gaianet start
+Port Already in Use
+
+Problem: Port 8080 is already occupied.
+Solution: Check what's using the port:
+bashsudo netstat -tulpn | grep :8080
+Kill the process or use a different port in your config.
+Memory Issues
+
+Problem: Node crashes with out of memory errors.
+Solution: Ensure you meet minimum requirements:
+4GB RAM minimum (8GB recommended)
+10GB free disk space
+RAG-Related Issues
+Node Responds to General Queries but Not Specific Ones
+
+Problem: RAG database retrieval issues with domain-specific questions.
+Solution:
+Check your snapshot was properly imported
+Review logs: ~/gaianet/log/start-llamaedge.log
+Verify your knowledge base was correctly processed