Installer HitKeep avec Homebrew sur macOS et Linux

Homebrew est la méthode d’installation prise en charge la plus directe pour HitKeep sur macOS avec Apple Silicon et sur Ubuntu Linux avec une architecture AMD64 ou ARM64. Le tap officiel installe la version stable actuelle du binaire hitkeep ; HitKeep continue de stocker ses données localement et utilise la même configuration que tout autre déploiement auto-hébergé.

Plateforme	Prise en charge par Homebrew
macOS ARM64 (Apple Silicon)	Validée par la CI
Ubuntu Linux AMD64/x86_64	Validée par la CI avec Linuxbrew
Ubuntu Linux ARM64	Validée par la CI avec Linuxbrew

À chaque version, la CI installe la formule stable, la met à niveau vers la version candidate, vérifie la version installée, exécute brew test, puis la désinstalle sur chacune des plateformes indiquées.

Démarrage rapide

Installez HitKeep depuis le dépôt officiel :

brew install PascaleBeier/hitkeep/hitkeep
hitkeep --version

Créez des répertoires persistants explicites, générez un secret de session et démarrez une instance locale :

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

Ouvrez http://localhost:8080 et terminez l’assistant de configuration.

Consultez la référence de configuration pour les URL de production, la messagerie, le stockage, S3, MCP et les paramètres d’IA facultatifs.

Vérifier l’installation

Dans un autre terminal, confirmez la formule installée, exécutez son test et contrôlez les deux sondes d’exécution :

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

/healthz confirme que le processus est actif. /readyz confirme que la base partagée et toutes les bases d’espace ouvertes sont prêtes à servir le trafic.

Mettre à niveau

Consultez les notes de version, puis actualisez les métadonnées Homebrew et mettez la formule à niveau :

brew update
brew upgrade hitkeep
brew list --versions hitkeep

Redémarrez le processus HitKeep en cours d’exécution après la mise à niveau. Homebrew remplace l’exécutable, sans déplacer ni supprimer les chemins de données que vous avez configurés.

Sauvegarder

Le démarrage rapide active le service de sauvegarde cohérente de HitKeep dans $HOME/.local/share/hitkeep/backups. Conservez ce répertoire sur un stockage durable et testez une restauration avant de le considérer comme une sauvegarde de production.

Un plan de sauvegarde complet comprend :

le chemin HITKEEP_DB_PATH configuré ;
l’intégralité de HITKEEP_DATA_PATH, y compris tenants/*/hitkeep.db ;
les chemins d’archive et de sauvegarde configurés ;
les éventuels objets S3 externes lorsque ces chemins utilisent des URL s3://.

Consultez Sauvegarde et restauration pour la procédure de restauration et Sauvegardes S3 pour le stockage hors machine.

Remarques pour la production

Placez HitKeep derrière HTTPS et définissez HITKEEP_PUBLIC_URL sur l’URL exacte visible dans le navigateur.
Configurez les proxys de confiance lorsque le trafic traverse un proxy inverse ou un répartiteur de charge.
Exécutez HitKeep avec un gestionnaire de services macOS s’il doit démarrer automatiquement ; ne placez pas les secrets dans l’historique du shell ni dans les arguments de commande du service.
Consultez le guide du binaire Linux pour les serveurs utilisant systemd.