RoqueOS Server इंस्टॉलेशन

RoqueOS को क्लाउड कंप्यूटिंग के शक्तिशाली सेल्फ-होस्टेड प्लेटफ़ॉर्म में बदलें। Docker के साथ इंस्टॉल करें और Linux टर्मिनल, रिमोट ब्राउज़र, App Store Docker, फ़ाइल मैनेजर और बहुत कुछ अनलॉक करें।

---

पूर्व-आवश्यकताएं

पूर्व-आवश्यकताएं

आपको Linux (अनुशंसित Ubuntu/Debian) या macOS/Windows चलाने वाली मशीन की आवश्यकता होगी जिसमें Docker और Docker Compose स्थापित हो।

Docker नहीं है? जारी रखने से पहले Docker Engine इंस्टॉल करें।

---

अनुशंसित इंस्टॉलेशन (one-liner)

तेज़ तरीका — install.sh (Linux/macOS) और install.ps1 (Windows) सब कुछ संभालते हैं: images pull, क्रिप्टोग्राफिक secrets बनाता है, volumes कॉन्फ़िगर करता है, कंटेनर ऊपर लाता है और admin स्वागत पैनल दिखाता है।

Linux / macOS

curl -fsSL https://roqueos.com.br/install.sh | bash

Windows

irm https://roqueos.com.br/install.ps1 | iex

~2 मिनट में सर्वर http://localhost:27021 पर चलता है। flags का पूर्ण विवरण (--update, --with-roqueclaw, --with-android-gaming, स्वचालित रोलबैक): Linux/macOS इंस्टॉलर या Windows।

💡 अगला कदम

सर्वर चलने के बाद, Add Server Wizard के माध्यम से इसे अपने RoqueOS web से कनेक्ट करें। या यदि आप कुछ भी इंस्टॉल किए बिना Server Mode का परीक्षण करना चाहते हैं, तो पहले से कॉन्फ़िगर किए गए सार्वजनिक डेमो सर्वर का उपयोग करें।

---

मैन्युअल इंस्टॉलेशन (उन्नत — fallback)

उन्नत

यह अनुभाग उन परिदृश्यों के लिए मौजूद है जहां उपरोक्त one-liner कवर नहीं करता (उदाहरण: GitHub Container Registry तक पहुंच के बिना नेटवर्क, curl | bash को ब्लॉक करने वाली कॉर्पोरेट नीति, air-gapped environment)। 99% उपयोगकर्ताओं के लिए, उपरोक्त one-liner का उपयोग करें जो यहां वर्णित सब कुछ स्वचालित करता है।

यहां मैन्युअल निर्देश पुराने हो सकते हैं — install.sh सही प्रवाह का सत्य का स्रोत है।

जो लोग कंटेनरों को स्वयं प्रबंधित करना पसंद करते हैं उनके लिए।

1. सुरक्षा कुंजियाँ उत्पन्न करें

सर्वर को production में तीन क्रिप्टोग्राफिक कुंजियों की आवश्यकता होती है। जारी रखने से पहले Node.js के साथ उन्हें उत्पन्न करें:

node -e "console.log('JWT_SECRET=' + require('crypto').randomBytes(32).toString('hex'))"
node -e "console.log('ENCRYPTION_KEY=' + require('crypto').randomBytes(32).toString('hex'))"
node -e "console.log('GUACAMOLE_CRYPT_KEY=' + require('crypto').randomBytes(16).toString('hex'))"

या, यदि आप OpenSSL पसंद करते हैं:

echo "JWT_SECRET=$(openssl rand -hex 32)"
echo "ENCRYPTION_KEY=$(openssl rand -hex 32)"
echo "GUACAMOLE_CRYPT_KEY=$(openssl rand -hex 16)"

तीन मान कॉपी करें और निम्नलिखित docker-compose.yml फ़ाइल में COLE_AQUI को बदलें।

अपनी कुंजियाँ रखें

production में JWT_SECRET या ENCRYPTION_KEY खोने के लिए सभी API Keys को फिर से बनाना और frontend को फिर से कनेक्ट करना आवश्यक है। उन्हें password manager या version control के बाहर .env फ़ाइल में स्टोर करें।

तकनीकी नोट — GUACAMOLE_CRYPT_KEY

Remote Desktop AES-256-CBC का उपयोग करता है, जिसके लिए ठीक 32 bytes की आवश्यकता होती है। randomBytes(16) कमांड 32 हेक्स वर्णों के रूप में 16 random bytes उत्पन्न करता है — जो UTF-8 में ठीक 32 bytes के बराबर है। इस विशिष्ट कुंजी के लिए हमेशा randomBytes(16) का उपयोग करें।

2. DockerHub से images डाउनलोड करें

docker pull roqueribeiro1988/roqueos-server:latest
docker pull roqueribeiro1988/roqueos-server-ubuntu:latest

3. docker-compose.yml फ़ाइल बनाएं

version: '3.8'

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    container_name: roqueos-server
    restart: unless-stopped
    ports:
      - '27021:27021'
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - roqueos-users:/data/roqueos/users
      - roqueos-shared:/data/roqueos/shared
      - roqueos-db:/app/data
      - roqueos-transcode-cache:/app/transcode-cache
    cap_add:
      - SYS_ADMIN
    shm_size: 1gb
    environment:
      - TZ=America/Sao_Paulo
      - NODE_ENV=production
      - JWT_SECRET=COLE_AQUI
      - ENCRYPTION_KEY=COLE_AQUI
      - GUACAMOLE_CRYPT_KEY=COLE_AQUI
      - UBUNTU_IMAGE=roqueribeiro1988/roqueos-server-ubuntu:latest
      - GUACD_HOST=guacd
      - GUACD_PORT=4822
    networks:
      - roqueos-network

  guacd:
    image: guacamole/guacd:1.6.0
    container_name: roqueos-guacd
    restart: unless-stopped
    networks:
      - roqueos-network

volumes:
  roqueos-users:
  roqueos-shared:
  roqueos-db:
  roqueos-transcode-cache:

networks:
  roqueos-network:
    driver: bridge

4. सर्वर शुरू करें

docker compose up -d

---

अनुकूली मीडिया स्ट्रीमिंग (HLS)

v1.0.5 से, सर्वर उपलब्ध हार्डवेयर का स्वचालित रूप से पता लगाता है और video streaming pipeline को कॉन्फ़िगर करता है:

प्रोफ़ाइल	CPU / RAM	उपलब्ध गुणवत्ता	Encoder
low	≤ 2 cores या ≤ 2 GB RAM	480p	Software (libx264 ultrafast)
mid	4 cores + 4 GB RAM	480p + 720p	Software या hardware
high	≥ 6 cores + 8 GB RAM	480p + 720p + 1080p	Hardware प्राथमिकता

HLS segments cache वॉल्यूम roqueos-transcode-cache में रहता है और restarts के बीच persistent रहता है।

---

AI एजेंट — RoqueClaw (v1.0.6+)

RoqueClaw RoqueOS के साथ एकीकृत AI के साथ visual automation एजेंट है। इसे सक्षम करने के लिए, roqueos-server service के environment अनुभाग में अपने docker-compose.yml में जोड़ें:

- ENABLE_ROQUECLAW=true
- OPENCLAW_IMAGE=roqueribeiro1988/roqueos-openclaw:latest

सर्वर पहले रन पर एजेंट image को स्वचालित रूप से डाउनलोड करेगा।

---

नए संस्करण के लिए अपडेट

जब Docker Hub पर नया संस्करण प्रकाशित होता है, तो आप तीन तरीकों से अपडेट कर सकते हैं:

अनुशंसित

RoqueOS के अंदर Server Admin → संस्करण → "अभी अपडेट करें" का उपयोग करें। सहायक आपकी इंस्टॉलेशन विधि का पता लगाता है, सटीक कमांड दिखाता है और restart को स्वचालित रूप से ट्रैक करता है।

Docker Compose

docker compose pull && docker compose up -d --force-recreate roqueos-server

इंस्टॉलेशन स्क्रिप्ट (Linux/macOS)

curl -fsSL https://roqueos.com.br/install.sh | bash -s -- --update

इंस्टॉलेशन स्क्रिप्ट (Windows)

& ([scriptblock]::Create((irm https://roqueos.com.br/install.ps1))) -Update

आपका डेटा सुरक्षित है

Docker के नामित volumes (roqueos-users, roqueos-shared, roqueos-db, roqueos-transcode-cache) अपडेट के दौरान संरक्षित रहते हैं। डेटाबेस, कॉन्फ़िगरेशन और फ़ाइलें प्रभावित नहीं होतीं।

---

इंस्टॉलेशन सत्यापन

curl http://localhost:27021/health

अपेक्षित परिणाम:

{ "status": "ok", "timestamp": "2026-03-05T00:00:00.000Z", "version": "2.1.0" }

---

प्रशासन पैनल

इंस्टॉलेशन के बाद, प्रशासन पैनल यहां उपलब्ध है:

http://localhost:27021/api

---

अगले चरण

• VPS & Cloud — 24/7 एक्सेस के लिए रिमोट सर्वर पर इंस्टॉल करें
• Volumes (डिस्क) — फ़ाइल मैनेजर में स्थानीय फ़ोल्डरों को मैप करें
• App Store Docker — एक क्लिक में Docker एप्लिकेशन इंस्टॉल करें