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.

Escolha como instalar

O servidor do RoqueOS roda inteiramente via Docker. Você pode instalar usando nosso script automatizado ou configurar tudo manualmente se preferir ter mais controle.

PRÉ-REQUISITOS

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

---

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

O RoqueOS é construído utilizando duas imagens: a aplicação principal em Node.js e o container de runtime (Ubuntu) para a funcionalidade de terminal.

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

2. Crie o arquivo docker-compose.yml

Crie um diretório para o servidor, entre nele e crie o arquivo compose:

version: '3.8'

services:
  roqueos-server:
    image: roqueribeiro1988/roqueos-server:latest
    container_name: roqueos-server
    restart: unless-stopped
    ports:
      - '27021:27021' # API, WebSocket e Painel de Admin
    volumes:
      - ./data:/app/data
      - /var/run/docker.sock:/var/run/docker.sock # Necessário para App Store e Containers
    environment:
      - TZ=America/Sao_Paulo

3. Inicie o servidor

Execute o comando de inicialização dentro da mesma pasta onde criou o arquivo compose:

docker compose up -d

---

Verificando a Instalação

Para garantir que seu servidor subiu corretamente, você pode verificar o status de saúde da API chamando o endpoint /health:

curl http://localhost:27021/health

Resultado esperado:

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

---

Próximos Passos

Seu servidor está rodando, mas para utilizá-lo, você precisará:

1. Acessar o Painel de Administração para criar uma Chave de API de acesso seguro.
2. Conectar essa chave no seu frontend web do RoqueOS.

Siga para a página de Mapeamento de Volumes (Discos) para aprender como adicionar seus arquivos locais no RoqueOS.