Installare KIVO sul tuo server

1Scarica l'immagine e la licenza

Dopo l'acquisto ricevi un'email con la licenza in allegato (license.key) e il link per scaricare l'immagine. Lo stesso link resta disponibile nella pagina del tuo ordine su Lemon Squeezy.

Crea una cartella sul server e mettici dentro i due file:

mkdir -p ~/kivo && cd ~/kivo
ls
# kivo-selfhost-1.0.0.tar.gz  license.key

2Carica l'immagine in Docker

docker load -i kivo-selfhost-*.tar.gz

Docker risponde con Loaded image: kivo-selfhost:latest e la versione precisa, per esempio kivo-selfhost:1.0.0. Le due etichette indicano la stessa immagine.

3Avvia KIVO

Il modo consigliato è Docker Compose, perché la configurazione resta scritta in un file. Crea docker-compose.yml nella stessa cartella:

services:
  kivo:
    image: kivo-selfhost:latest
    container_name: kivo
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - ./license.key:/app/license.key:ro

docker compose up -d

Se preferisci un solo comando, senza file:

docker run -d --name kivo --restart unless-stopped \
  -p 3000:3000 \
  -v "$PWD/license.key:/app/license.key:ro" \
  kivo-selfhost:latest

4Controlla che funzioni

Apri http://indirizzo-del-server:3000 nel browser. Se in cima alla pagina non compare nessun avviso giallo, la licenza è attiva.

Dal server puoi controllare anche da terminale:

curl http://localhost:3000/api/health
curl http://localhost:3000/api/license

La prima risposta dice che KIVO è in piedi e quale versione stai usando:

{"ok":true,"edition":"selfhost","version":"…","released":"…"}

La seconda mostra la licenza: "state":"valid", a chi è intestata, il piano e fino a quando sono inclusi gli aggiornamenti.

5Mettilo dietro HTTPS

Su localhost KIVO funziona già del tutto. Da altri computer della rete serve HTTPS: i browser attivano funzioni come l'uso offline, la fotocamera del lettore QR, il microfono del registratore e la copia negli appunti solo su connessioni sicure.

Il modo più semplice è Caddy, che ottiene e rinnova il certificato da solo. Basta un file Caddyfile:

kivo.example.com {
  reverse_proxy localhost:3000
}

Se hai già nginx con un certificato aziendale:

server {
  listen 443 ssl;
  server_name kivo.example.com;

  ssl_certificate     /etc/ssl/kivo.crt;
  ssl_certificate_key /etc/ssl/kivo.key;

  location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-Proto $scheme;
  }
}

Aggiornamenti

Ogni nuova versione arriva come nuovo file kivo-selfhost-….tar.gz, allo stesso link. Per aggiornare:

docker load -i kivo-selfhost-*.tar.gz
docker compose up -d

La licenza resta quella che hai: non va reinstallata. Se una versione nuova ti dà problemi, torni a quella prima indicando la versione al posto di latest nel file compose (per esempio image: kivo-selfhost:1.0.0) e rilanciando docker compose up -d. La versione precedente è ancora in Docker finché non la cancelli.

Come funziona la licenza

• È perpetua. La versione che hai la puoi usare per sempre.
• Gli aggiornamenti hanno una scadenza, di solito 12 mesi dall'acquisto (illimitati con il piano lifetime). Copre ogni versione uscita entro quella data.
• Se installi una versione uscita dopo la scadenza, KIVO funziona comunque ma mostra un avviso finché non rinnovi gli aggiornamenti.
• Viene verificata sul tuo server, con una firma digitale. KIVO non contatta mai i nostri server, nemmeno per controllarla.
• Quando rinnovi ricevi una nuova license.key. Sostituisci il file: l'avviso sparisce al caricamento successivo della pagina, senza riavviare.

Per rinnovare incolla la licenza su kivotool.com/it/self-host/renew. I termini completi sono su /self-host/license, anche nella tua installazione.

Reti isolate, senza Internet

L'immagine contiene già tutto: i motori per PDF, video e audio, il riconoscimento del testo con le lingue, il modello che toglie lo sfondo. Non scarica nulla all'avvio e non apre connessioni in uscita: niente statistiche, niente CDN, niente controllo della licenza da remoto.

Per una rete senza Internet ti basta portare i due file sul server (con una chiavetta, per esempio) e seguire i passi qui sopra. Se vuoi verificarlo, blocca il traffico in uscita del container sul firewall: KIVO continua a funzionare uguale.

Configurazione

Per esempio, con la licenza passata come variabile:

docker run -d -p 3000:3000 -e KIVO_LICENSE="$(cat license.key)" kivo-selfhost:latest

Non c'è nient'altro da salvare nei backup oltre a license.key e al file compose. Le Ricette e le preferenze delle persone restano nei loro browser, non sul server.

Problemi comuni

Disinstallare

docker compose down
docker image rm kivo-selfhost:latest

Sul server non resta altro. Se ti serve aiuto in qualsiasi momento, rispondi all'email della licenza indicando il suo codice (KV-…) e la risposta di /api/health.