Installa la tua copia

Con un comando Consigliato

La tua copia viene installata nel tuo account Cloudflare: un Worker con l’app web, l’API e il server MCP, un database SQLite e un bucket R2 per gli allegati.

Ti serve un account Cloudflare (basta il piano gratuito) e Node.js 22.12 o successivo.

Prima di iniziare, attiva R2 nella dashboard di Cloudflare, in R2 → Overview (si apre in una nuova scheda). L’utilizzo incluso è gratuito (10 GB di spazio al mese), anche se Cloudflare potrebbe chiederti un metodo di pagamento. Serve a entrambi i metodi di installazione su Cloudflare: il comando e il pulsante.

$ npx create-orqevio

1. Si apre il browser per farti accedere a Cloudflare.
2. Scegli un nome per la copia (orqevio di default), che diventa parte del suo indirizzo.
3. L’installer esegue il deploy della copia e crea il suo bucket.
4. Ti mostra l’indirizzo (https://orqevio.<tuo-sottodominio>.workers.dev) e un codice di configurazione monouso.

Apri l’indirizzo e segui i passaggi del primo accesso.

• Più copie: aggiungi --name <nome> a qualsiasi comando.
• Più account Cloudflare: l’installer ti chiede quale usare, oppure indicalo con --account <id>.
• Se il browser non si apre per l’accesso, apri il link che mostra l’installer. Se neanche così funziona, accedi a parte con npx wrangler login --browser=false ed esegui di nuovo l’installer.
• Lingua: l’installer parla la lingua del tuo terminale; scegline un’altra con --lang <codice>.
• Privacy: l’installer disattiva la telemetria di Wrangler, a meno che non l’abbia attivata tu, e lavora in una cartella temporanea che elimina quando ha finito.

Con il pulsante

Se preferisci tenere la tua copia in un tuo repository su GitHub o GitLab:

Cloudflare crea un piccolo repository nel tuo account GitHub o GitLab, ti chiede il codice di configurazione (SETUP_CODE), che scegli tu, ed esegue il deploy della copia. Da lì in poi:

• A ogni modifica di quel repository il deploy parte in automatico.
• Dependabot ti propone le nuove versioni di Orqevio in una pull request; quando ne fai il merge, la tua copia si aggiorna.
• Se perdi la chiave, cambia il segreto SETUP_CODE nella dashboard di Cloudflare e usa «Hai perso la chiave?» nella schermata di accesso.

Con Docker sul tuo server

Un unico container (per amd64 e arm64) con il suo database SQLite e gli allegati in un volume. Scarica la configurazione:

$ 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

Modifica .env: imposta in APP_URL l’indirizzo pubblico della tua copia (per esempio https://orqevio.tuo-dominio.com) e, se vuoi, un SETUP_CODE scelto da te di almeno 12 lettere o cifre. Poi:

$ docker compose up -d

La copia è in ascolto sulla porta 3000. Mettila dietro un reverse proxy con HTTPS (Caddy, Nginx o Traefik) e aggiungi TRUST_PROXY=true a .env.

Backup: copia il volume orqevio-data a copia ferma, oppure fai un backup a caldo del database con sqlite3 e conserva anche la cartella uploads.

Primo accesso

1. Prendi possesso della tua copia. Apri il suo indirizzo e inserisci il codice di configurazione e il tuo nome. Su Cloudflare te lo dà l’installer; con Docker è il SETUP_CODE di .env oppure, se non ne hai impostato uno, quello che trovi nel log del container (docker compose logs app).
2. Salva la tua chiave di accesso. Orqevio genera una chiave casuale a 160 bit e la mostra una sola volta. Salvala nel tuo gestore di password: è tutto ciò che ti serve per accedere da qualsiasi dispositivo.
3. Se la perdi, genera un nuovo codice con npx create-orqevio@latest recover (Cloudflare) o docker compose exec app node dist/cli.js reset-access (Docker) e usalo in «Hai perso la chiave?». La tua cassaforte non ne risente: il server non conosce mai la sua password principale.

La tua copia usa la lingua del browser con cui ne prendi possesso: inglese, spagnolo, francese, portoghese, italiano, tedesco, olandese o giapponese. Puoi cambiarla quando vuoi in Impostazioni.

Collega gli agenti

L’indirizzo MCP della tua copia è https://<tua-copia>/mcp.

• Claude sul web, su desktop e su mobile: aggiungi un connettore personalizzato con quell’indirizzo. La tua copia ti chiede il permesso in una schermata in cui scegli lo spazio e cosa può farci Claude. La tua copia deve essere raggiungibile in HTTPS da Internet; su Cloudflare lo è già.
• Claude Code, Cursor, VS Code e altri: in Agenti → Collega un agente crei un token e l’app ti dà la configurazione da incollare.

Nessun agente può leggere la cassaforte, nemmeno cifrata, e nessuno può eliminare: possono solo archiviare, e tu puoi ripristinare.

Aggiorna

La tua copia ti avvisa in Impostazioni → Questa copia quando c’è una nuova versione, con il passaggio esatto per la tua installazione. I tuoi dati, la tua chiave e la tua cassaforte vengono sempre mantenuti.

Disinstalla

Impostazioni → Disinstallare Orqevio elimina tutto per sempre: spazi, documenti, allegati, la cassaforte e l’accesso dei tuoi agenti. Confermi con la tua chiave di accesso e scrivendo il nome della copia. Poi la copia ti mostra come rimuovere ciò che resta:

Costi

Orqevio non costa nulla. Con Docker paghi il tuo server. Su Cloudflare, per l’uso personale basta il piano gratuito:

Limiti aggiornati a novembre 2026. Controlla quelli in vigore nella documentazione di Cloudflare.