Instala KIVO en tu propio servidor

1Descarga la imagen y la licencia

Después de comprar recibes un email con la licencia adjunta (license.key) y un enlace para descargar la imagen. El mismo enlace sigue disponible en la página de tu pedido en Lemon Squeezy.

Crea una carpeta en el servidor y pon ahí los dos archivos:

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

2Carga la imagen en Docker

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

Docker responde con Loaded image: kivo-selfhost:latest y la versión exacta, por ejemplo kivo-selfhost:1.0.0. Las dos etiquetas son la misma imagen.

3Arranca KIVO

Docker Compose es la vía recomendada, porque la configuración queda escrita en un archivo. Crea docker-compose.yml en la misma carpeta:

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

Si prefieres un solo comando, sin archivo:

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

4Comprueba que funciona

Abre http://tu-servidor:3000 en un navegador. Si no aparece ningún aviso amarillo arriba, la licencia está activa.

Desde el servidor también puedes comprobarlo en una terminal:

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

La primera respuesta dice que KIVO está en marcha y qué versión usas:

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

La segunda muestra la licencia: "state":"valid", a quién está emitida, el plan y cuándo terminan las actualizaciones incluidas.

5Ponlo detrás de HTTPS

En localhost KIVO ya funciona del todo. Desde otros ordenadores de la red necesita HTTPS: los navegadores solo activan el uso sin conexión, la cámara del lector QR, el micrófono de la grabadora y la copia al portapapeles en conexiones seguras.

La vía más sencilla es Caddy, que obtiene y renueva el certificado solo. Basta un Caddyfile:

kivo.example.com {
  reverse_proxy localhost:3000
}

Si ya usas nginx con un certificado de empresa:

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;
  }
}

Actualizaciones

Cada versión nueva llega como un nuevo archivo kivo-selfhost-….tar.gz, en el mismo enlace. Para actualizar:

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

Tu licencia se queda como está: no hay nada que reinstalar. Si una versión nueva te da problemas, vuelve atrás indicando la versión en lugar de latest en el archivo compose (por ejemplo image: kivo-selfhost:1.0.0) y ejecutando de nuevo docker compose up -d. La versión anterior sigue en Docker hasta que la borres.

Cómo funciona la licencia

• Es perpetua. Puedes usar la versión que tienes para siempre.
• Las actualizaciones tienen fecha de fin, normalmente 12 meses desde la compra (ilimitadas en el plan de por vida). Toda versión publicada antes de esa fecha está cubierta.
• Si instalas una versión publicada después de esa fecha, KIVO sigue funcionando pero muestra un aviso hasta que renueves las actualizaciones.
• Se comprueba en tu propio servidor, con una firma digital. KIVO nunca contacta con nuestros servidores, ni siquiera para comprobarla.
• Al renovar recibes un nuevo license.key. Sustituye el archivo: el aviso desaparece en la siguiente carga de página, sin reiniciar.

Para renovar, pega tu licencia en kivotool.com/es/self-host/renew. Los términos completos están en /self-host/license, también en tu propia instalación.

Redes aisladas, sin Internet

La imagen ya lo contiene todo: los motores de PDF, vídeo y audio, el reconocimiento de texto con sus idiomas, el modelo para quitar fondos. No descarga nada al arrancar y no abre conexiones salientes: sin analítica, sin CDN, sin comprobación remota de la licencia.

Para una red sin Internet, lleva los dos archivos al servidor (en una memoria USB, por ejemplo) y sigue los pasos de arriba. Para verificarlo, bloquea en el cortafuegos el tráfico saliente del contenedor: KIVO sigue funcionando exactamente igual.

Configuración

Por ejemplo, con la licencia pasada como variable:

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

No hay nada que copiar aparte de license.key y el archivo compose. Las Recetas y preferencias de cada persona viven en su propio navegador, no en el servidor.

Problemas habituales

Desinstalar

docker compose down
docker image rm kivo-selfhost:latest

No queda nada más en el servidor. Si necesitas ayuda en cualquier momento, responde al email de tu licencia con su código (KV-…) y la salida de /api/health.