Instalar HitKeep con Homebrew en macOS y Linux

Homebrew es la vía de instalación con soporte más directa para HitKeep en macOS con Apple Silicon y en Ubuntu Linux con AMD64 o ARM64. El tap oficial instala el binario estable actual de hitkeep; HitKeep sigue almacenando los datos localmente y usa la misma configuración que cualquier otro despliegue autogestionado.

Plataforma	Compatibilidad con Homebrew
macOS ARM64 (Apple Silicon)	Validada por CI
Ubuntu Linux AMD64/x86_64	Validada por CI con Linuxbrew
Ubuntu Linux ARM64	Validada por CI con Linuxbrew

La CI de publicación instala la fórmula estable, la actualiza a la versión candidata, verifica la versión instalada, ejecuta brew test y la desinstala en cada una de las plataformas indicadas.

Inicio rápido

Instala HitKeep desde el tap oficial:

brew install PascaleBeier/hitkeep/hitkeep
hitkeep --version

Crea directorios persistentes explícitos, genera un secreto de sesión e inicia una instancia local:

mkdir -p "$HOME/.local/share/hitkeep"/{data,archive,backups}

export HITKEEP_PUBLIC_URL=http://localhost:8080
export HITKEEP_JWT_SECRET="$(openssl rand -hex 32)"
export HITKEEP_BIND_ADDR=127.0.0.1:7946
export HITKEEP_DB_PATH="$HOME/.local/share/hitkeep/data/hitkeep.db"
export HITKEEP_DATA_PATH="$HOME/.local/share/hitkeep/data"
export HITKEEP_ARCHIVE_PATH="$HOME/.local/share/hitkeep/archive"
export HITKEEP_BACKUP_PATH="$HOME/.local/share/hitkeep/backups"

hitkeep

Abre http://localhost:8080 y completa el asistente de configuración.

Conserva el secreto de sesión

El comando anterior sirve para un inicio rápido local. Antes de depender de esta instancia, guarda un único valor estable de HITKEEP_JWT_SECRET en un archivo de entorno con permisos restringidos o en la configuración del servicio. Generar un secreto distinto en cada inicio cierra las sesiones de los usuarios.

Consulta la referencia de configuración para configurar URL de producción, correo, almacenamiento, S3, MCP y las opciones de IA.

Verificación

En otra terminal, confirma la fórmula instalada, ejecuta la prueba de la fórmula del tap y comprueba ambos endpoints de ejecución:

brew list --versions hitkeep
brew test PascaleBeier/hitkeep/hitkeep
curl --fail http://localhost:8080/healthz
curl --fail http://localhost:8080/readyz

/healthz confirma que el proceso está activo. /readyz confirma que la base de datos compartida y todas las bases de datos de tenants abiertas están listas para servir tráfico.

Actualización

Revisa las notas de la versión, actualiza los metadatos de Homebrew y la fórmula:

brew update
brew upgrade hitkeep
brew list --versions hitkeep

Reinicia el proceso de HitKeep después de la actualización. Homebrew reemplaza el ejecutable, pero no mueve ni elimina las rutas de datos que hayas configurado.

Copias de seguridad

El inicio rápido activa el worker de copias de seguridad con checkpoints de HitKeep en $HOME/.local/share/hitkeep/backups. Mantén ese directorio en almacenamiento duradero y prueba una restauración antes de considerarlo una copia de seguridad de producción.

Un plan de copias de seguridad completo incluye:

• el valor configurado en HITKEEP_DB_PATH;
• el árbol completo de HITKEEP_DATA_PATH, incluido tenants/*/hitkeep.db;
• las rutas configuradas para archivos y copias de seguridad;
• cualquier objeto S3 externo cuando esas rutas usen URL s3://.

Consulta Copias de seguridad y restauración para los procesos de restauración y Copias de seguridad en S3 para el almacenamiento fuera de la máquina.

Notas para producción

• Publica HitKeep mediante HTTPS y define HITKEEP_PUBLIC_URL con la URL exacta visible en el navegador.
• Configura los proxies de confianza cuando el tráfico pase por un proxy inverso o un balanceador de carga.
• Ejecuta HitKeep bajo un gestor de servicios de macOS si debe iniciarse automáticamente; no guardes secretos en el historial del shell ni en los argumentos del comando del servicio.
• Usa la guía del binario para Linux para servidores basados en systemd.