🌐 Эта страница еще не переведена на русский. Показана португальская (BR) версия. Помочь с переводом.

Primeiros Passos

Bem-vindo ao RoqueOS! Este guia vai te ajudar a começar em menos de 5 minutos.

Antes de começar

Para	Você precisa de
Usar o RoqueOS	um navegador atualizado (Chrome, Edge, Safari ou Firefox). Só isso.
Instalar como app	o mesmo navegador — a instalação é do próprio navegador, não um download
Modo servidor	uma máquina com Docker: mini PC, Raspberry Pi, NAS ou VPS. O instalador cuida do resto
RoqueOS Cloud	nada além do cadastro — a máquina é provisionada para você

Nenhum passo deste guia precisa de conhecimento de Linux. Os que precisam de terminal são uma linha só, para copiar e colar.

---

O caminho inteiro, de uma olhada

Opção 1: Acesso Imediato pela Web

A forma mais rápida de experimentar o RoqueOS é acessar diretamente pelo navegador, sem nenhuma instalação:

👉 roqueos.com.br

Crie uma conta com seu e-mail e você já estará dentro do seu desktop web pessoal.

---

Opção 2: Instalar como App (PWA)

Para uma experiência mais próxima de um aplicativo nativo, instale o RoqueOS como Progressive Web App (PWA):

1. Acesse roqueos.com.br no Chrome, Edge ou Safari.
2. Clique no ícone de instalação na barra de endereços (ou no menu do navegador).
3. Selecione "Instalar" ou "Adicionar à tela inicial".

Sem internet

Depois da primeira visita, o RoqueOS abre sem internet, instalado ou não: o desktop, a tela de bloqueio e os dez idiomas ficam guardados no aparelho em poucos segundos. Cada app entra nessa cópia na primeira vez que você o abre com rede e continua funcionando offline dali em diante, inclusive depois das atualizações. Um app que você nunca abriu neste aparelho precisa de internet na primeira vez; sem rede, a janela dele diz "Sem conexão".

---

Opção 3: Apps Nativos

Baixe o RoqueOS direto nas lojas de aplicativos para a melhor experiência em cada plataforma:

Plataforma	Link
Windows	Microsoft Store
iOS / macOS	Apple App Store
Android	Google Play

---

Conhecendo a Interface

Ao entrar no RoqueOS pela primeira vez, você verá:

Elementos Principais

• Desktop: Área de trabalho com atalhos personalizáveis
• Barra de Tarefas: Na parte inferior, com apps abertos e relógio
• Launchpad: Grade de todos os aplicativos disponíveis; a busca acha o app pelo nome no seu idioma, com ou sem acento ("camera" acha a Câmera)
• Spotlight: Busca rápida (atalho no topo da tela)

---

Apps Incluídos

O RoqueOS vem com 80 aplicativos integrados organizados por categoria:

Categoria	Apps
Sistema	Gerenciador de Arquivos, Configurações, Link Catalog
Mídia	Music Player, Video Player, Camera, Audio Recorder, Image Viewer, Screen Capture
Produtividade	Chat IA, Sticky Notes, Calculator, Text Editor, PDF Viewer, QR Code, Google Apps
Desenvolvimento	VS Code, Terminal Linux, Containers Docker, Roque Code, Roqueman
Servidor	Navegador Remoto, Remote Desktop
Entretenimento	Games, NEXO, VOLT, UNDA, EKO, LUMEN, NOVA, SkyStack e mais
IA	RoqueClaw (Agente IA)

👉 Veja a documentação completa dos aplicativos para guias detalhados de cada um.

---

Conectar ao Servidor (Modo Self-Hosted)

Quer desbloquear o potencial completo, terminal Linux real, VS Code com extensões, 155+ apps Docker prontos, navegador remoto, RoqueClaw agente IA?

🚀 Quer testar Server Mode SEM instalar nada?

Faça login em /app, abra Settings → Server e selecione o servidor DEMO já pré-configurado. É um servidor público compartilhado pra você explorar Terminal, VS Code, Containers, App Store Docker. Bom pra decidir se vale a pena instalar o seu próprio.

Limites do demo: dados resetam a cada ~24h, compartilhado entre todos os visitantes. Pra uso real, instale o seu próprio (instruções abaixo).

Passo 1: Subir o servidor

Linux / macOS (one-liner):

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

Windows (PowerShell):

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

Em ~2 min o roqueos-server está rodando em http://localhost:27021. Detalhes: Instalador Linux/macOS ou Windows.

☁️ Prefere não administrar servidor?

O RoqueOS Cloud é a versão managed, a gente cuida da infra, snapshots automáticos, suporte. Planos a partir de R$ 59/mês. Servidor provisionado em ~3 min depois do checkout.

Passo 2: Conectar via Wizard

No RoqueOS (/app):

1. Settings → Server → Adicionar servidor (botão "+" no topo)
2. Cole a URL do servidor (http://localhost:27021 se for local, ou https://seu-tunnel.com.br se for público)
3. Wizard detecta automaticamente se o servidor precisa de setup ou já está configurado
4. Servidor zerado: wizard cria a primeira admin key pra você, copia e cola no 1Password
5. Servidor já configurado: cole apiKey + apiSecret existentes
6. Dá um nome amigável (ex: "Casa", "VPS Hetzner") → Conectar

Detalhes do fluxo completo: Add Server Wizard, incluindo o aviso importante sobre HTTP vs HTTPS.

Passo 3: Aproveitar

Após conexão, Terminal, VS Code, App Store Docker, Remote Browser, Remote Desktop, RoqueClaw aparecem no Launchpad. Tudo "plug and play".

---

Quando o servidor não conecta

O que você vê	O que está acontecendo	O que fazer
O wizard não acha o servidor em http://localhost:27021	o navegador está em https e o servidor em http: o navegador bloqueia a mistura	abra o RoqueOS em http:// também, ou ponha o servidor atrás de HTTPS. Ver Add Server Wizard
Conecta, mas o Terminal e o VS Code não aparecem	a conexão caiu depois de entrar, ou a chave não tem permissão	confira em Ajustes → Servidor se ele está verde, e se a chave é de administrador
O instalador termina e localhost:27021 não responde	o Docker não subiu, ou a porta já estava ocupada	docker ps mostra se o container está de pé; a porta se troca no instalador
Um app aparece com a etiqueta Servidor e não abre	é um app que exige servidor, e não há nenhum conectado	conecte um servidor, ou use os apps que rodam só no navegador
Entrou, mas as notas e os links sumiram	você entrou com outra conta	os dados vivem na conta, não no aparelho

Próximos Passos

• Instalador Linux/macOS: One-liner com --update, --with-roqueclaw, etc.
• Instalador Windows: PowerShell equivalent
• App Store Docker: 155+ apps prontos pra 1 clique
• Agente de IA RoqueClaw: instala containers via linguagem natural
• Cloud (managed): se preferir não administrar servidor