Instalar Korva

Korva se distribuye como tres binarios de un solo archivo: korva (CLI), korva-vault (el servidor local) y korva-sentinel (el validador pre-commit). Son Go puro (sin CGO), por lo que la instalación es la misma en todas las plataformas — deja los binarios en algún lugar de tu $PATH y listo.

Opción 1: instalador curl (macOS / Linux)

curl -fsSL https://korva.dev/install | bash

El script detecta tu OS y arquitectura, descarga el tarball correspondiente del último release de GitHub, verifica el checksum SHA256 e instala los tres binarios en:

1. $KORVA_INSTALL_DIR si lo defines explícitamente, o
2. /usr/local/bin si tiene permisos de escritura, o
3. ~/.local/bin (se crea si no existe).

Te avisa si el directorio de instalación no está en tu $PATH y sugiere la línea de configuración correcta para tu shell.

Para fijar una versión específica:

KORVA_VERSION=v1.0.0 curl -fsSL https://korva.dev/install | bash

Para instalar solo la CLI sin el servidor vault (útil en CI):

KORVA_NO_VAULT=yes curl -fsSL https://korva.dev/install | bash

Opción 2: Homebrew (macOS / Linux)

brew install alcandev/tap/korva

El tap se actualiza automáticamente con cada release. Las actualizaciones llegan vía brew upgrade korva.

Opción 3: PowerShell (Windows)

Ejecuta PowerShell como Administrador (para que el script pueda actualizar el PATH del sistema):

irm https://korva.dev/install.ps1 | iex

El script descarga el .zip correspondiente, extrae los tres binarios .exe a %LOCALAPPDATA%\korva\bin\ y actualiza tu PATH de usuario (PATH del sistema si tienes elevación). En sistemas donde korva.exe está actualmente en uso, el binario nuevo se deja con extensión .new y se renombra en el siguiente arranque.

Opción 4: Docker (vault self-hosted)

docker pull ghcr.io/alcandev/korva-vault:latest
docker compose up -d vault

Esto corre solo el servidor vault (puerto 7437). Para la máquina del developer, todavía quieres la CLI korva local que hable con él. Ver Self-hosting para el stack Compose completo con Traefik para HTTPS.

Verificar la instalación

korva --version
korva doctor

korva doctor corre 13+ chequeos: directorio home, config, binarios en PATH, vault alcanzable, install.id, hive.key, licencia, admin.key (si está presente), git disponible, BD del vault existe, config del proyecto, heartbeat de licencia. Cada línea debería mostrar ✓ o una remediación clara.

Dónde queda todo

Durante la instalación no se envía nada por la red más allá de la descarga del release de GitHub. No hay telemetría.

Siguiente: Quickstart en 5 minutos