---
title: "Instalar HitKeep con Homebrew en macOS y Linux | HitKeep"
description: "Instala, verifica y actualiza HitKeep, y haz copias de seguridad de HitKeep en macOS ARM64 o Ubuntu Linux AMD64 y ARM64 mediante el tap oficial de Homebrew."
canonical: "https://hitkeep.com/es/guides/installation/homebrew/"
---

# 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](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](https://hitkeep.com/reference/configuration/) 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](https://github.com/PascaleBeier/hitkeep/releases/latest), 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](https://hitkeep.com/guides/data/backups-and-restore/) para los procesos de restauración y [Copias de seguridad en S3](https://hitkeep.com/guides/data/s3-backups/) 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](https://hitkeep.com/guides/installation/trusted-proxies/) 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](https://hitkeep.com/es/guides/installation/binary/) para servidores basados en systemd.

[Página anterior Vista general](https://hitkeep.com/es/guides/installation/)[Siguiente página Binario para Linux](https://hitkeep.com/es/guides/installation/binary/)