Instalação do RoqueOS Server

Transforme o RoqueOS em uma poderosa plataforma self-hosted de cloud computing. Instale com Docker e libere terminal Linux, navegador remoto, App Store Docker, gerenciador de arquivos e muito mais.

---

Pré-Requisitos

PRÉ-REQUISITOS

Você precisará de uma máquina rodando Linux (Ubuntu/Debian recomendados) ou macOS/Windows com Docker e Docker Compose instalados.

Não tem Docker? Instale o Docker Engine antes de continuar.

---

Opção 1: Instalação Automática (Recomendado)

A maneira mais fácil e rápida. O script fará o download e configurará tudo para você.

Linux / macOS

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

Windows

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

Após a execução, o servidor já estará rodando e pronto para receber conexões do frontend.

---

Opção 2: Instalação Manual

Para quem prefere gerenciar os containers por conta própria.

1. Baixe as imagens do DockerHub

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

2. Crie o arquivo 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. Inicie o servidor

docker compose up -d

---

Verificando a Instalação

curl http://localhost:27021/health

Resultado esperado:

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

---

Painel de Administração

Após a instalação, o Painel de Administração está disponível em:

http://localhost:27021/api

No painel, você pode:

• Criar e gerenciar Chaves de API para conectar o frontend
• Monitorar containers e serviços em execução
• Configurar túneis Cloudflare para acesso seguro externo

---

Conectando ao Frontend

1. Abra o RoqueOS em roqueos.com.br ou no app nativo.
2. Acesse Configurações → Servidor.
3. Insira a URL do servidor (ex: http://localhost:27021 ou https://seu-tunel.trycloudflare.com).
4. Cole a Chave de API gerada no painel de administração.
5. Clique em Conectar.

---

Próximos Passos

• VPS & Cloud — Instale em um servidor remoto para acesso 24/7
• Volumes (Discos) — Mapeie suas pastas locais no gerenciador de arquivos
• App Store Docker — Instale aplicações Docker com um clique