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.
Scegli prima una modalità di autenticazione
Sezione intitolata “Scegli prima una modalità di autenticazione”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.
Scegli un percorso di installazione
Sezione intitolata “Scegli un percorso di installazione”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.
Requisiti di sistema
Sezione intitolata “Requisiti di sistema”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.
Azioni riservate all’operatore
Sezione intitolata “Azioni riservate all’operatore”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.
bin/ots org transfer-ownership ORG NEW_OWNERORG è 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.
Ottenere aiuto
Sezione intitolata “Ottenere aiuto”- Il repository GitHub per il codice sorgente, le note di rilascio e gli stack Compose forniti.
- Il tracker delle issue per i bug, con il tag della release e le righe di log pertinenti.
- Contattaci direttamente per qualsiasi altra cosa.