# Panoramica del self-hosting

> Cosa comporta eseguire la tua istanza di Onetime Secret, quale modalità di autenticazione scegliere per prima e dove trovare le istruzioni di installazione e per gli operatori.

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

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](/en/self-hosting/simple-or-full-auth) spiega cosa sblocca ciascuna modalità, dove deve risiedere quel database e quanto è difficile cambiare modalità in seguito.

## 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](/en/install/docker#running-a-single-container) 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](/en/install/images-and-variants) — quale delle immagini pubblicate eseguire e come funzionano i tag di release.
* [Installazione con Docker](/en/install/docker) — i due stack Compose forniti dal progetto.
* [Installazione su Linux](/en/install/linux) — un’installazione bare metal su Debian o Ubuntu. Nessun’altra famiglia di distribuzioni è coperta dai test di installazione del progetto.
* [Esecuzione come servizio](/en/install/run-as-a-service) — le unit systemd fornite nel repository e il runner Procfile per gli host senza systemd.
* [Reverse proxy e TLS](/en/install/reverse-proxy-and-tls) — l’applicazione non termina mai TLS, quindi si presuppone un proxy davanti a essa. Leggilo prima di esporre l’istanza.
* [Verifica dell’installazione](/en/install/verify) — dimostra che l’istanza risponde davvero alle richieste prima di consegnarla a qualcuno, e [crea il primo account](/en/install/verify#create-the-first-account): il ruolo di operatore del sito viene concesso solo dalla CLI.

Stai aggiornando un’installazione esistente? Le [Guide all’aggiornamento](/en/self-hosting/upgrade-guides) 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

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

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.

```bash
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](/en/organizations/ownership-and-transfer), che è ciò che i tuoi utenti avranno letto prima di rivolgersi a te.

## Ottenere aiuto

* [Il repository GitHub](https://github.com/onetimesecret/onetimesecret) per il codice sorgente, le note di rilascio e gli stack Compose forniti.
* [Il tracker delle issue](https://github.com/onetimesecret/onetimesecret/issues) per i bug, con il tag della release e le righe di log pertinenti.
* [Contattaci](https://onetimesecret.com/feedback) direttamente per qualsiasi altra cosa.