Installation du Serveur RoqueOS

Transformez RoqueOS en une puissante plateforme de cloud computing auto-hébergée. Installez avec Docker pour débloquer un terminal Linux, un navigateur distant, le Docker App Store, un gestionnaire de fichiers, et bien plus encore.

---

Prérequis

PRÉREQUIS

Vous aurez besoin d'une machine fonctionnant sous Linux (Ubuntu/Debian recommandé) ou macOS/Windows avec Docker et Docker Compose installés.

Vous n'avez pas Docker ? Installez Docker Engine avant de continuer.

---

Option 1 : Installation Automatique (Recommandée)

La méthode la plus simple et la plus rapide. Le script téléchargera et configurera tout pour vous.

Linux / macOS

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

Windows

iwr -useb https://roqueos.com.br/install.ps1 | iex

Après exécution, le serveur sera en marche et prêt à recevoir les connexions du frontend.

---

Option 2 : Installation Manuelle

Pour ceux qui préfèrent gérer les conteneurs eux-mêmes.

1. Télécharger les images depuis DockerHub

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

2. Créer le fichier 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:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TZ=America/Sao_Paulo

3. Démarrer le serveur

docker compose up -d

---

Vérifier l'Installation

curl http://localhost:27021/health

Résultat attendu :

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

---

Panneau d'Administration

Après l'installation, le Panneau d'Administration est disponible à l'adresse :

http://localhost:27021/api

Dans le panneau, vous pouvez :

• Créer et gérer des Clés API pour connecter le frontend
• Surveiller les conteneurs et services en cours d'exécution
• Configurer des tunnels Cloudflare pour un accès externe sécurisé

---

Connexion au Frontend

1. Ouvrez RoqueOS sur roqueos.com.br ou dans l'application native.
2. Allez dans Paramètres → Serveur.
3. Entrez l'URL du serveur (ex. http://localhost:27021 ou https://votre-tunnel.trycloudflare.com).
4. Collez la Clé API générée dans le panneau d'administration.
5. Cliquez sur Connecter.

---

Prochaines Étapes

• VPS & Cloud — Installez sur un serveur distant pour un accès 24/7
• Volumes (Disques) — Mappez vos dossiers locaux dans le gestionnaire de fichiers
• Docker App Store — Installez des applications Docker en un clic