Instale sua cópia

Com um comando Recomendado

Sua cópia é instalada na sua própria conta da Cloudflare: um Worker com o app web, a API e o MCP, um banco de dados SQLite e um bucket R2 para os anexos.

Você precisa de uma conta da Cloudflare (o plano gratuito basta) e do Node.js 22.12 ou mais recente.

Antes de começar, ative o R2 no painel da Cloudflare, em R2 → Overview (abre em uma nova aba). O uso incluído é gratuito (10 GB de armazenamento por mês), embora a Cloudflare possa pedir uma forma de pagamento. As duas formas de instalar na Cloudflare precisam dele: o comando e o botão.

$ npx create-orqevio

1. O navegador abre para você fazer login na Cloudflare.
2. Você escolhe um nome para a cópia (orqevio por padrão), que passa a fazer parte do endereço dela.
3. O instalador faz o deploy da cópia e cria o bucket dela.
4. No final, ele mostra o endereço (https://orqevio.<seu-subdominio>.workers.dev) e um código de configuração de uso único.

Abra o endereço e siga os passos do primeiro acesso.

• Várias cópias: adicione --name <nome> a qualquer comando.
• Várias contas da Cloudflare: o instalador pergunta qual usar, ou você a informa com --account <id>.
• Se o navegador não abrir para fazer login, abra o link que o instalador mostra. Se isso também não funcionar, faça login separadamente com npx wrangler login --browser=false e execute o instalador de novo.
• Idioma: o instalador fala o idioma do seu terminal; escolha outro com --lang <código>.
• Privacidade: o instalador desativa a telemetria do Wrangler, a menos que você mesmo a tenha ativado, e trabalha em uma pasta temporária que é apagada no final.

Com o botão

Se você prefere manter sua cópia em um repositório seu no GitHub ou no GitLab:

A Cloudflare cria um pequeno repositório na sua conta do GitHub ou do GitLab, pede o código de configuração (SETUP_CODE), que você mesmo escolhe, e faz o deploy da cópia. A partir daí:

• Cada alteração nesse repositório dispara um deploy automático.
• O Dependabot propõe as novas versões do Orqevio em um pull request; ao fazer o merge, sua cópia é atualizada.
• Se você perder a chave, altere o segredo SETUP_CODE no painel da Cloudflare e use “Perdeu sua chave?” na tela de login.

Com Docker no seu servidor

Um único contêiner (para amd64 e arm64), com o banco de dados SQLite e os anexos em um volume. Baixe a configuração:

$ curl -fsSLO https://raw.githubusercontent.com/hsylabs/orqevio/main/docker-compose.yml

$ curl -fsSL -o .env https://raw.githubusercontent.com/hsylabs/orqevio/main/.env.example

Edite o .env: coloque em APP_URL o endereço público da sua cópia (por exemplo, https://orqevio.seu-dominio.com) e, se quiser, um SETUP_CODE próprio, com pelo menos 12 letras ou dígitos. Depois:

$ docker compose up -d

A cópia escuta na porta 3000. Coloque-a atrás de um proxy reverso com HTTPS (Caddy, Nginx ou Traefik) e adicione TRUST_PROXY=true ao .env.

Backups: copie o volume orqevio-data com a cópia parada, ou faça um backup a quente do banco de dados com sqlite3 e guarde também a pasta uploads.

Primeiro acesso

1. Configure sua cópia. Abra o endereço dela e digite o código de configuração e seu nome. Na Cloudflare, quem fornece o código é o instalador; com Docker, é o SETUP_CODE do .env ou, se você não definiu nenhum, o que aparece no log do contêiner (docker compose logs app).
2. Guarde sua chave de acesso. O Orqevio gera uma chave aleatória de 160 bits e a mostra uma única vez. Guarde-a no seu gerenciador de senhas: ela é tudo de que você precisa para entrar em qualquer dispositivo.
3. Se você a perder, gere um novo código com npx create-orqevio@latest recover (Cloudflare) ou docker compose exec app node dist/cli.js reset-access (Docker) e use-o em “Perdeu sua chave?”. Seu cofre não é afetado: o servidor nunca conhece a senha mestra dele.

Sua cópia adota o idioma do seu navegador no momento em que você a configura: inglês, espanhol, francês, português, italiano, alemão, holandês ou japonês. Você pode mudá-lo quando quiser em Configurações.

Conectar agentes

O endereço MCP da sua cópia é https://<sua-copia>/mcp.

• Claude na web, no desktop e no celular: adicione um conector personalizado com esse endereço. Sua cópia pede sua permissão em uma tela em que você escolhe o espaço e o que o agente pode fazer. Para isso, sua cópia precisa estar acessível via HTTPS pela internet; na Cloudflare, ela já está.
• Claude Code, Cursor, VS Code e outros: em Agentes → Conectar um agente, você cria um token e o app mostra a configuração para colar.

Nenhum agente consegue ler o cofre, nem mesmo criptografado, e nenhum pode excluir nada: eles só podem arquivar, e você pode restaurar.

Atualizar

Sua cópia avisa em Configurações → Esta cópia quando há uma nova versão, com o passo exato para a sua instalação. Seus dados, sua chave e seu cofre são sempre preservados.

Desinstalar

Configurações → Desinstalar o Orqevio apaga tudo para sempre: espaços, documentos, anexos, o cofre e o acesso dos seus agentes. Você confirma com sua chave de acesso e digitando o nome da cópia. Depois, a cópia mostra como remover o que sobrou:

Custos

O Orqevio não custa nada. Com Docker, você paga pelo seu servidor. Na Cloudflare, o plano gratuito basta para uso pessoal:

Limites de novembro de 2026. Confira os valores atuais na documentação da Cloudflare.