Instalación del Servidor RoqueOS

Transforma RoqueOS en una potente plataforma de computación en la nube autoalojada. Instala con Docker para desbloquear un terminal Linux, un navegador remoto, la Docker App Store, el administrador de archivos y mucho más.

---

Requisitos Previos

REQUISITOS PREVIOS

Necesitarás una máquina con Linux (se recomienda Ubuntu/Debian) o macOS/Windows con Docker y Docker Compose instalados.

¿No tienes Docker? Instala Docker Engine antes de continuar.

---

Opción 1: Instalación Automática (Recomendada)

La forma más fácil y rápida. El script descargará y configurará todo por ti.

Linux / macOS

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

Windows

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

Después de la ejecución, el servidor estará en funcionamiento y listo para recibir conexiones desde el frontend.

---

Opción 2: Instalación Manual

Para aquellos que prefieren gestionar los contenedores por su cuenta.

1. Descargar imágenes de DockerHub

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

2. Crear el archivo 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. Iniciar el servidor

docker compose up -d

---

Verificación de la Instalación

curl http://localhost:27021/health

Resultado esperado:

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

---

Panel de Administración

Después de la instalación, el Panel de Administración está disponible en:

http://localhost:27021/api

En el panel, puedes:

• Crear y gestionar Claves API para conectar el frontend
• Monitorear contenedores y servicios en ejecución
• Configurar túneles de Cloudflare para acceso externo seguro

---

Conexión al Frontend

1. Abre RoqueOS en roqueos.com.br o en la aplicación nativa.
2. Ve a Configuración → Servidor.
3. Ingresa la URL del servidor (ej. http://localhost:27021 o https://tu-tunel.trycloudflare.com).
4. Pega la Clave API generada en el panel de administración.
5. Haz clic en Conectar.

---

Próximos Pasos

• VPS & Cloud — Instala en un servidor remoto para acceso 24/7
• Volúmenes (Discos) — Mapea tus carpetas locales en el administrador de archivos
• Docker App Store — Instala aplicaciones Docker con un solo clic