Vai al contenuto

Stai visualizzando il sito di documentazione in anteprimaI contenuti qui servono per i test e possono differire dalla documentazione di produzione.

Vai alla documentazione di produzione

Panoramica del self-hosting

Esegui la tua istanza e ogni segreto, account e riga di log resta su un’infrastruttura che controlli tu. Decidi come vengono autenticati gli account, se l’istanza debba essere raggiungibile dalla rete Internet pubblica e quale branding mostra l’interfaccia.

La modalità determina cos’altro deve essere in esecuzione, quindi stabiliscila prima di installare.

simple è l’impostazione predefinita e richiede solo il datastore Valkey/Redis. full aggiunge un database SQL per gli account, che per impostazione predefinita è SQLite in sqlite://data/auth.db; PostgreSQL è un’opzione supportata, non un requisito. In un container quel file ha bisogno di un volume montato per sopravvivere a un riavvio.

Simple o Full spiega cosa sblocca ciascuna modalità, dove deve risiedere quel database e quanto è difficile cambiare modalità in seguito.

Hai fretta e disponi già di un Valkey o Redis in esecuzione? Il singolo comando docker run in Installazione con Docker avvia un’istanza sulla porta 3000 con un valore SECRET generato. Tutto il resto in questa pagina continua a valere una volta che è attiva.

  • Immagini e varianti — quale delle immagini pubblicate eseguire e come funzionano i tag di release.
  • Installazione con Docker — i due stack Compose forniti dal progetto.
  • Installazione su Linux — un’installazione bare metal su Debian o Ubuntu. Nessun’altra famiglia di distribuzioni è coperta dai test di installazione del progetto.
  • Esecuzione come servizio — le unit systemd fornite nel repository e il runner Procfile per gli host senza systemd.
  • Reverse proxy e TLS — l’applicazione non termina mai TLS, quindi si presuppone un proxy davanti a essa. Leggilo prima di esporre l’istanza.
  • Verifica dell’installazione — dimostra che l’istanza risponde davvero alle richieste prima di consegnarla a qualcuno, e crea il primo account: il ruolo di operatore del sito viene concesso solo dalla CLI.

Stai aggiornando un’installazione esistente? Le Guide all’aggiornamento elencano le guide disponibili, dalla più recente. Inizia dalla prima guida successiva alla release che esegui ora e procedi in avanti, leggendo le note di rilascio di ogni release intermedia.

Consigliati per un’istanza in modalità di autenticazione simple:

  • 2+ core CPU
  • 2GB+ RAM
  • 10GB+ di spazio su disco

Un deployment in modalità full che esegue anche PostgreSQL, il worker in background e lo scheduler richiede all’incirca il doppio.

Alcune operazioni amministrative non hanno una schermata nell’applicazione e si eseguono dalla riga di comando dell’istanza.

Il trasferimento di un’organizzazione a un nuovo proprietario è la principale. I proprietari dell’organizzazione non dispongono di una schermata né di un endpoint per farlo, quindi il trasferimento spetta a te. Usa il comando qui sotto. Per l’automazione, l’API Colonel espone la stessa operazione in POST /api/colonel/organizations/:org_id/transfer-ownership; richiede il ruolo colonel, accetta il nome dell’organizzazione come conferma e si applica immediatamente, senza anteprima.

Terminale
bin/ots org transfer-ownership ORG NEW_OWNER

ORG è l’ID pubblico dell’organizzazione (extid, l’ID mostrato dalla CLI) o il suo ID interno (objid). NEW_OWNER è un indirizzo email, l’extid di un cliente o un ID account Rodauth, e deve già essere un membro attivo: il comando non crea mai un cliente, quindi esegui prima bin/ots memberships add ORG CUSTOMER se non lo è.

Eseguito senza --yes, pianifica il trasferimento prima di toccare qualsiasi cosa, mostrando chi perde la proprietà, quante appartenenze da proprietario verrebbero retrocesse e a quale ruolo, e poi ti chiede conferma. Rispondere n è il modo per vedere l’anteprima di un trasferimento. Le opzioni sono --demote-to ROLE (qualsiasi ruolo di appartenenza tranne owner, predefinito admin), --yes (anche -y e -f) e --json.

Il proprietario uscente viene retrocesso, non rimosso. L’operazione promuove il nuovo proprietario prima di retrocedere quello precedente — la protezione contro l’assenza di proprietario rifiuta qualsiasi altro ordine — quindi per la durata di quelle due scritture l’organizzazione ha due appartenenze da proprietario e bin/ots org doctor segnala il controllo 4 (membership_role_sync) come avviso. Se un trasferimento viene interrotto in quella finestra, riesegui il comando di trasferimento, non org doctor. Il trasferimento è idempotente e retrocede ogni altro proprietario; org doctor contrassegna quel controllo come repairable: false e non lo corregge.

Il lato utente finale di tutto questo è Proprietà e trasferimento, che è ciò che i tuoi utenti avranno letto prima di rivolgersi a te.