Installa Kept

Scegli come esegui Kept, poi segui i suoi passi. Ogni strada ha una guida completa in questa sezione; il link è alla fine dei suoi passi.

In un terminale

• Docker ComposeUna macchina
• KubernetesCon Helm
• Dal codice sorgenteLa tua immagine

Con un clic

• Home AssistantCome app

Docker Compose

Cosa ti serve

Docker con il plugin Compose, e un terminale. Testato con 1 GB di RAM e un core CPU; Kept e il suo database ne usano circa 200–400 MB (cosa è stato testato).

1. Scarica compose.yaml in una cartella tutta sua: Kept e il suo database in un solo file, senza copia del repository e senza password da creare.

   mkdir kept && cd kept
   curl -fsSLO https://raw.githubusercontent.com/keptinventory/kept/v1.14.7/compose.yaml

2. Scrivi .env. init chiede l’indirizzo a cui aprirai Kept, come http://kept.home.arpa:8080. Usa un nome invece di un indirizzo IP: le etichette stampate lo riportano.

   docker compose run --rm init

   Dovresti vedere

   Wrote .env.
   
   KEPT SETUP CODE: XXX-XXX
   
   Next: docker compose up -d, then open http://kept.home.arpa:8080 and enter the setup code.

3. Avvialo. Parte il database, due servizi monouso creano i suoi accessi e applicano le migrazioni, poi Kept parte sulla porta 8080.

   docker compose up -d

   Dovresti vedere

   All’indirizzo, la pagina Inserisci il codice di configurazione di Kept.

4. Configuralo. Inserisci il codice che init ha mostrato e crea il primo account: diventa l’admin dell’istanza.

5. Tieni al sicuro le chiavi. Stampa il kit di ripristino e conservalo in un posto diverso da questo server, come un gestore di password. Un backup riporta i valori segreti solo con queste chiavi.

   docker compose exec kept kept admin recovery-kit

   Dovresti vedere

   Un testo che inizia con KEPT RECOVERY KIT.

Windows

In PowerShell, scrivi curl.exe dove i passi dicono curl, ed esegui mkdir kept e cd kept uno alla volta. Oppure esegui tutti i passi in WSL.

Ogni passo per intero, con Caddy per HTTPS e Ollama per l’IA locale: Installa con Docker Compose.

Kubernetes

Non ancora testato su un cluster reale

Il chart viene generato e validato a ogni controllo, e ogni release lo pubblica insieme all’immagine, ma non è ancora stato installato su un cluster reale. Tratta una prima installazione come una prova.

Cosa ti serve

Un cluster Kubernetes come k3s, kubectl e helm, e un terminale. Il chart chiede 384 MiB di memoria per Kept (al massimo 1 GiB) e 256 MiB per il suo Postgres incluso (al massimo 512 MiB).

1. Crea i secret. Il chart non scrive mai un secret: gli accessi al database e il superuser del Postgres incluso prendono le password da secret che crei prima.

   kubectl create namespace kept
   pw() { openssl rand -hex 32; }
   # The four database logins (always).
   kubectl -n kept create secret generic kept-db \
     --from-literal=KEPT_DB_OWNER_PASSWORD="$(pw)" --from-literal=KEPT_DB_APP_PASSWORD="$(pw)" \
     --from-literal=KEPT_DB_AUTH_PASSWORD="$(pw)" --from-literal=KEPT_DB_SYSTEM_PASSWORD="$(pw)"
   # The bundled Postgres's superuser (or, for external Postgres with roles.create, the server admin's password).
   kubectl -n kept create secret generic kept-postgres --from-literal=POSTGRES_PASSWORD="$(pw)"

2. Installa il chart, con publicUrl sull’indirizzo che le persone apriranno. Non aggiungere --wait a questa prima installazione: le migrazioni girano dopo.

   helm install kept oci://ghcr.io/keptinventory/charts/kept --version 1.14.7 -n kept \
     --set publicUrl=https://kept.example.org \
     --set roles.existingSecret=kept-db --set postgres.superuserSecret=kept-postgres

   Dovresti vedere

   La prima riga delle note che Helm stampa:

   Kept 1.14.7 is installed as "kept" in namespace "kept".

3. Trova il codice di configurazione. Kept lo stampa una volta, al primo avvio.

   kubectl -n kept logs deploy/kept | grep 'KEPT SETUP CODE'

   Dovresti vedere

   KEPT SETUP CODE: XXX-XXX

   Apri l’indirizzo, inserisci il codice e crea il primo account: diventa l’admin dell’istanza.

4. Tieni al sicuro le chiavi. Salva il kit di ripristino e tienilo fuori dal cluster.

   kubectl -n kept exec deploy/kept -- kept admin recovery-kit > kept-recovery-kit.txt

   Dovresti vedere

   kept-recovery-kit.txt, che inizia con KEPT RECOVERY KIT.

5. Verificalo. helm test chiede al Kept in esecuzione /readyz e /version.

   helm test kept -n kept

Su Windows, esegui questi comandi in WSL. I valori, i secret facoltativi e cosa esegue il chart: Installa su Kubernetes con Helm.

Dal codice sorgente

Cosa ti serve

Git, Docker con il plugin Compose, e un terminale. Kept gira come con Docker Compose, sulla tua immagine.

1. Prendi il codice.

   git clone https://github.com/keptinventory/kept.git && cd kept

2. Costruisci l’immagine, con il tag kept:local.

   docker build -t kept:local .

3. Scrivi .env. Punta compose.yaml alla tua immagine, poi esegui init. Trova il .env, chiede se aggiornarlo (rispondi Y), poi chiede l’indirizzo a cui aprirai Kept.

   echo KEPT_IMAGE=kept:local >> .env
   docker compose run --rm init

   Dovresti vedere

   Updated .env.
   
   KEPT SETUP CODE: XXX-XXX

4. Avvialo e apri l’indirizzo.

   docker compose up -d

   Dovresti vedere

   La pagina Inserisci il codice di configurazione di Kept. Inserisci il codice che init ha mostrato e crea il primo account: diventa l’admin dell’istanza.

5. Tieni al sicuro le chiavi. Stampa il kit di ripristino e conservalo in un posto diverso da questo server.

   docker compose exec kept kept admin recovery-kit

   Dovresti vedere

   Un testo che inizia con KEPT RECOVERY KIT.

Su Windows, esegui questi comandi in WSL. Lo stesso compose.yaml di una release, spiegato per intero: Installa con Docker Compose.

Home Assistant

Cosa ti serve

Home Assistant OS con Supervisor 2026.10.4 o successivo: le app richiedono Supervisor, quindi non Home Assistant Container né Core. Una macchina aarch64 o amd64, come un Raspberry Pi 4 o 5 a 64 bit o un mini PC. 4 GB di memoria; 2 GB bastano con poche altre app. Nessun terminale.

1. Aggiungi il repository di Kept. Il pulsante apre il tuo Home Assistant con il repository già inserito. Oppure vai in Impostazioni → App → Installa app → ⋮ → Repository e aggiungi https://github.com/keptinventory/kept.

   Aggiungi Kept a Home Assistant

2. Installa, poi Inizia. Trova Kept nello store delle app, poi Installa, poi Inizia.

   Dovresti vedere

   Nella scheda Log dell’app, l’indirizzo proprio di Kept e il codice di configurazione:

   Kept is at http://homeassistant.local:8080 (change it in Configuration: "Kept's address")

   KEPT SETUP CODE: XXX-XXX

3. Open Web UI. Kept si apre dentro Home Assistant, anche nella barra laterale.

   Dovresti vedere

   Per un amministratore di Home Assistant, Crea il primo account, senza codice. Chiunque altro vede Inserisci il codice di configurazione e digita il codice dalla scheda Log.

L’indirizzo di Kept, https e i backup: Installa come app di Home Assistant.

Qualcosa non funziona?

• Il container continua a riavviarsi. Leggi il suo log: docker compose logs kept. Kept controlla le sue impostazioni prima di partire e si ferma con una riga che nomina il primo problema, come kept: invalid environment: KEPT_PUBLIC_URL (esegui docker compose run --rm init). Se docker compose up -d si ferma a bootstrap, docker compose logs bootstrap dice perché. Con meno di 1 GB di memoria, un backup può esaurirla e Docker riavvia Kept (cosa serve). Altro
• La porta è occupata. Kept usa la porta 8080 dell’host. Esegui di nuovo docker compose run --rm init con un indirizzo http:// su una porta libera: scrive l’indirizzo e la porta (KEPT_HTTP_PORT) in .env. Poi docker compose up -d. Nell’app di Home Assistant, cambia la porta in Configurazione → Rete e imposta Indirizzo di Kept di conseguenza. Altro
• Permesso negato. Kept gira come utente 10001 con un filesystem in sola lettura, quindi una cartella che ci monti, come una directory di backup, deve appartenere all’uid 10001. init scrive .env nella cartella da cui lo esegui: eseguilo in una cartella tua. Altro
• Gli altri dispositivi non lo aprono. localhost si apre solo su questa macchina. Usa un nome che gli altri dispositivi trovano, impostato nel DNS del router o nel file hosts di ogni dispositivo, ed esegui di nuovo init con quello. Se Kept dice «Questo Kept è configurato per indirizzo. Aprilo lì.», aprilo esattamente a quell’indirizzo, oppure aggiungi l’altro in KEPT_EXTRA_ADDRESSES (più di un indirizzo). Altro
• Un 502 dal reverse proxy. Kept parla HTTP semplice sulla porta 8080: punta il proxy a http://, non https://, su quella porta (dietro un reverse proxy). Kept parte solo quando migrate ha finito; se è fallito, docker compose logs migrate dice perché. Altro

Tutto il resto: Risoluzione dei problemi.

Andare oltre

• HTTPS: la fotocamera, l’installazione dell’app, le notifiche push e la posizione ne hanno bisogno. Metti Kept su HTTPS, oppure Kept su una rete di casa per cosa funziona senza.
• L’assistente: chiedi a parole semplici, con il tuo fornitore di IA; Kept funziona anche senza. Fornitori di IA, e Collega un client AI (MCP).
• Backup: ogni notte e cifrati, verso una directory, S3 o SFTP. Backup.
• Posta: reimpostazione delle password, inviti e promemoria per posta, con KEPT_SMTP_URL e KEPT_SMTP_FROM. Posta, push e il feed del calendario.
• Home Assistant: l’integrazione porta ciò che è in scadenza nelle dashboard e nelle automazioni. Home Assistant.

Aggiornamenti

• Docker Compose: imposta la nuova release in KEPT_IMAGE di .env, poi:

  docker compose pull
  docker compose up -d

  Una release che cambia compose.yaml lo dice nelle sue note: scarica il suo file sopra il tuo.

• Dal codice sorgente:

  git pull
  docker build -t kept:local .
  docker compose up -d

• Kubernetes: ogni release pubblica un chart con la stessa versione, e le sue migrazioni girano in un Job prima che la nuova versione serva.

• Home Assistant: Home Assistant propone l’aggiornamento. Attiva Mantieni il backup dell’ultima versione nella sua finestra di aggiornamento.

Con una destinazione di backup impostata, Kept fa uno snapshot prima di migrare. Aggiornamenti e rollback.