---
title: "Installer HitKeep avec Homebrew sur macOS et Linux | HitKeep"
description: "Installez, vérifiez, mettez à niveau et sauvegardez HitKeep sur macOS ARM64 ou Ubuntu Linux AMD64 et ARM64 avec le dépôt Homebrew officiel."
canonical: "https://hitkeep.com/fr/guides/installation/homebrew/"
---

# 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](http://localhost:8080/) et terminez l’assistant de configuration.

Conservez durablement le secret de session

La commande ci-dessus convient à un démarrage rapide en local. Avant de dépendre de cette instance, enregistrez une valeur stable de `HITKEEP_JWT_SECRET` dans un fichier d’environnement ou une configuration de service aux permissions restreintes. Générer un secret différent à chaque démarrage déconnecte les utilisateurs.

Consultez la [référence de configuration](https://hitkeep.com/reference/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](https://github.com/PascaleBeier/hitkeep/releases/latest), 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](https://hitkeep.com/guides/data/backups-and-restore/) pour la procédure de restauration et [Sauvegardes S3](https://hitkeep.com/guides/data/s3-backups/) 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](https://hitkeep.com/guides/installation/trusted-proxies/) 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](https://hitkeep.com/fr/guides/installation/binary/) pour les serveurs utilisant systemd.

[Précédent Vue d’ensemble](https://hitkeep.com/fr/guides/installation/)[Suivant Binaire Linux](https://hitkeep.com/fr/guides/installation/binary/)