From ffa7434258e623b6a64771b81548e3b3d7caf528 Mon Sep 17 00:00:00 2001 From: ViktorVasylenko <82339377+VasilenkoViktor@users.noreply.github.com> Date: Fri, 11 Jul 2025 03:22:52 +0300 Subject: [PATCH 1/2] Create stable_node_guide.md Step-by-step instructions on running RL-Swarm on WSL (Ubuntu 22.04) with memory control and swap enabled for stability. --- docs/stable_node_guide.md | 77 +++++++++++++++++++++++++++++++++++++++ 1 file changed, 77 insertions(+) create mode 100644 docs/stable_node_guide.md diff --git a/docs/stable_node_guide.md b/docs/stable_node_guide.md new file mode 100644 index 00000000..355e7d4e --- /dev/null +++ b/docs/stable_node_guide.md @@ -0,0 +1,77 @@ +# Stable Setup of RL-Swarm Node on WSL (Ubuntu) with RAM Limit & SWAP + +Цей гайд допоможе стабільно запустити ноду RL-Swarm локально через WSL2 + Ubuntu 22.04, використовуючи обмеження RAM та додаткову SWAP-пам'ять. + +--- + +## ✅ Середовище + +- ОС: Windows 10 / 11 +- WSL2 (Windows Subsystem for Linux) +- Ubuntu 22.04 (встановлено з Microsoft Store) +- Обмеження RAM + SWAP +- Інсталяція виключно через офіційні команди + +--- + +## 🧰 Підготовка: RAM та SWAP (налаштування в Windows) + +1. Відкрий файл `C:\Users\ТВОЄ_ІМ'Я\.wslconfig` (створи, якщо його немає) +2. Встав наступне: + +[wsl2] +memory=6GB +processors=4 +swap=16GB +localhostForwarding=true + +3. Збережи файл +4. Перезапусти WSL: +```powershell +wsl --shutdown + +🐧 Встановлення Ubuntu 22.04 через WSL +- Відкрий Microsoft Store +- Знайди та встанови Ubuntu 22.04 LTS +- Запусти "Ubuntu" з меню Пуск +- Створи користувача та пароль (одноразово) + +🚀 Встановлення RL-Swarm (тільки офіційні команди): +cd ~ +rm -rf rl-swarm +git clone https://github.com/gensyn-ai/rl-swarm.git +cd rl-swarm +python3 -m venv venv +sudo apt update +sudo apt install -y python3 python3-pip +pip install pycosat +tmux new -s swarm +./run_rl_swarm.sh + +🟡 Вихід із tmux не зупиняє ноду: +Ctrl + B, потім D +Повернутись: tmux attach -t swarm + +📦 Альтернатива: Створення SWAP вручну в Ubuntu (якщо потрібно) +sudo fallocate -l 8G /swapfile +sudo chmod 600 /swapfile +sudo mkswap /swapfile +sudo swapon /swapfile +Щоб зробити постійним: +echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab +Перевірити: +free -h + +🧪 Перевірка +Відкрий htop → перевір RAM/SWAP +Впевнись, що порт 3000 відкритий (через tmux) +За потреби — зроби SSH-тунель з Windows (локальний перегляд) + +🔍 Підсумки +VPS (Time4VPS) — спостерігались проблеми після декількох годин. +Локальний запуск у WSL із RAM 6 ГБ + SWAP 16 ГБ — стабільна робота >24 годин. +Всі команди відповідають офіційній документації. + +🗨️ Зв'язок +Знайшли покращення? Пишіть у Discord або створіть новий Pull Request 🙌 +Contributed by: Viktorino 🇺🇦 From e46b17623e197cf5443069ee5ce97df25aa24007 Mon Sep 17 00:00:00 2001 From: ViktorVasylenko <82339377+VasilenkoViktor@users.noreply.github.com> Date: Sun, 20 Jul 2025 03:24:56 +0300 Subject: [PATCH 2/2] Update stable_node_guide.md --- docs/stable_node_guide.md | 115 ++++++++++++++++++++++++++------------ 1 file changed, 79 insertions(+), 36 deletions(-) diff --git a/docs/stable_node_guide.md b/docs/stable_node_guide.md index 355e7d4e..1b5a8809 100644 --- a/docs/stable_node_guide.md +++ b/docs/stable_node_guide.md @@ -1,42 +1,56 @@ -# Stable Setup of RL-Swarm Node on WSL (Ubuntu) with RAM Limit & SWAP +# Stable Setup of RL‑Swarm Node on WSL (Ubuntu) with RAM Limit & SWAP -Цей гайд допоможе стабільно запустити ноду RL-Swarm локально через WSL2 + Ubuntu 22.04, використовуючи обмеження RAM та додаткову SWAP-пам'ять. +This guide shows how to run your RL‑Swarm node **locally** on Windows using **WSL2 + Ubuntu 22.04**, including memory limiting and swap configuration for stability. --- -## ✅ Середовище +## ✅ Environment -- ОС: Windows 10 / 11 -- WSL2 (Windows Subsystem for Linux) -- Ubuntu 22.04 (встановлено з Microsoft Store) -- Обмеження RAM + SWAP -- Інсталяція виключно через офіційні команди +- Windows 10 or 11 +- WSL2 (Windows Subsystem for Linux) +- Ubuntu 22.04 (installed from Microsoft Store) +- Limited RAM use and SWAP enabled +- Installation using only official commands --- -## 🧰 Підготовка: RAM та SWAP (налаштування в Windows) +## 🔧 WSL Configuration: Limit RAM & Enable SWAP -1. Відкрий файл `C:\Users\ТВОЄ_ІМ'Я\.wslconfig` (створи, якщо його немає) -2. Встав наступне: +Create or edit the file: +`C:\Users\\.wslconfig` +Insert the following: + +``` [wsl2] memory=6GB processors=4 swap=16GB localhostForwarding=true +``` + +Save the file, then run in PowerShell or Command Prompt: -3. Збережи файл -4. Перезапусти WSL: ```powershell wsl --shutdown +``` + +--- + +## 🐧 Install Ubuntu (if not installed yet) + +1. Open **Microsoft Store** +2. Search for **Ubuntu 22.04 LTS** and install +3. Launch **Ubuntu** from Start menu +4. Create your WSL username and password + +--- + +## 🚀 Install and Run RL‑Swarm (official steps only) -🐧 Встановлення Ubuntu 22.04 через WSL -- Відкрий Microsoft Store -- Знайди та встанови Ubuntu 22.04 LTS -- Запусти "Ubuntu" з меню Пуск -- Створи користувача та пароль (одноразово) +Open Ubuntu (WSL) terminal and run: -🚀 Встановлення RL-Swarm (тільки офіційні команди): +```bash cd ~ rm -rf rl-swarm git clone https://github.com/gensyn-ai/rl-swarm.git @@ -47,31 +61,60 @@ sudo apt install -y python3 python3-pip pip install pycosat tmux new -s swarm ./run_rl_swarm.sh +``` -🟡 Вихід із tmux не зупиняє ноду: -Ctrl + B, потім D -Повернутись: tmux attach -t swarm +> ℹ️ To detach from `tmux` without stopping the node, press: +> `Ctrl + B` then `D` +> To reattach: +> `tmux attach -t swarm` + +--- -📦 Альтернатива: Створення SWAP вручну в Ubuntu (якщо потрібно) +## 🔄 Optional: Create Swap File Manually in Ubuntu + +If swap isn't created by `.wslconfig`, run: + +```bash sudo fallocate -l 8G /swapfile sudo chmod 600 /swapfile sudo mkswap /swapfile sudo swapon /swapfile -Щоб зробити постійним: +``` + +To make swap permanent: + +```bash echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab -Перевірити: +``` + +Check swap with: + +```bash free -h +``` + +--- + +## 🧪 Verify Node Operation + +- Run `htop` to monitor RAM/SWAP usage +- Confirm that port `3000` is active (inside `tmux`) +- Access via browser (use SSH tunnel if necessary) + +--- + +## 🔍 Summary of Testing + +- VPS (Time4VPS): encountered instability after a few hours +- Local WSL with 6GB RAM + 16GB SWAP: stable 24+ hours +- All setup steps use only official commands +- Running inside `tmux` ensures node stays active during terminal disconnects + +--- + +## 💬 Feedback & Contributions -🧪 Перевірка -Відкрий htop → перевір RAM/SWAP -Впевнись, що порт 3000 відкритий (через tmux) -За потреби — зроби SSH-тунель з Windows (локальний перегляд) +Found this helpful? Feel free to share it in Discord or open another Pull Request to improve it further. -🔍 Підсумки -VPS (Time4VPS) — спостерігались проблеми після декількох годин. -Локальний запуск у WSL із RAM 6 ГБ + SWAP 16 ГБ — стабільна робота >24 годин. -Всі команди відповідають офіційній документації. +**Contributed by**: Viktorino 🇺🇦 -🗨️ Зв'язок -Знайшли покращення? Пишіть у Discord або створіть новий Pull Request 🙌 -Contributed by: Viktorino 🇺🇦