---
title: "HitKeep met Homebrew installeren op macOS en Linux | HitKeep"
description: "Installeer en controleer HitKeep op macOS ARM64 of Ubuntu Linux AMD64 en ARM64 via de officiële Homebrew-tap, voer een upgrade uit en maak een back-up van HitKeep."
canonical: "https://hitkeep.com/nl/guides/installation/homebrew/"
---

# HitKeep met Homebrew installeren op macOS en Linux

Homebrew is de kortste ondersteunde installatieroute voor HitKeep op macOS met Apple Silicon en Ubuntu Linux op AMD64 of ARM64. De officiële tap installeert de actuele stabiele `hitkeep`-binary; HitKeep bewaart zijn data nog steeds lokaal en gebruikt dezelfde configuratie als elke andere zelfgehoste implementatie.

| Platform | Homebrew-ondersteuning |
| --- | --- |
| macOS ARM64 (Apple Silicon) | Gevalideerd in CI |
| Ubuntu Linux AMD64/x86_64 | Gevalideerd in CI met Linuxbrew |
| Ubuntu Linux ARM64 | Gevalideerd in CI met Linuxbrew |

De CI voor releases installeert op elk vermeld platform de stabiele formule, upgradet die naar de releasecandidate, controleert de geïnstalleerde versie, voert `brew test` uit en verwijdert de formule weer.

## Snel aan de slag

Installeer HitKeep vanuit de officiële tap:

```
brew install PascaleBeier/hitkeep/hitkeep
hitkeep --version
```

Maak expliciete permanente mappen aan, genereer een sessiegeheim en start een lokale instantie:

```
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
```

Open [http://localhost:8080](http://localhost:8080/) en voltooi de installatiewizard.

Bewaar het sessiegeheim permanent

Het bovenstaande commando is bedoeld om lokaal snel aan de slag te gaan. Sla één vast `HITKEEP_JWT_SECRET` op in een omgevingsbestand met beperkte toegangsrechten of in je serviceconfiguratie voordat je op deze instantie vertrouwt. Een nieuw geheim bij elke start meldt gebruikers af.

Gebruik de [configuratiereferentie](https://hitkeep.com/reference/configuration/) voor productie-URL’s, e-mail, opslag, S3, MCP en optionele AI-instellingen.

## Controleren

Controleer in een andere terminal de geïnstalleerde formule, voer de formuletest van de tap uit en controleer beide runtimeprobes:

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

`/healthz` bevestigt dat het proces actief is. `/readyz` bevestigt dat de gedeelde database en elke geopende tenantdatabase klaar zijn om verkeer te verwerken.

## Upgraden

Bekijk de [releaseopmerkingen](https://github.com/PascaleBeier/hitkeep/releases/latest), werk daarna de Homebrew-metadata bij en upgrade de formule:

```
brew update
brew upgrade hitkeep
brew list --versions hitkeep
```

Herstart na de upgrade het actieve HitKeep-proces. Homebrew vervangt het uitvoerbare bestand; de geconfigureerde datapaden worden niet verplaatst of verwijderd.

## Back-up

De snelstart activeert HitKeeps checkpointgebaseerde back-upworker in `$HOME/.local/share/hitkeep/backups`. Bewaar die map op duurzame opslag en test een herstelprocedure voordat je deze als productieback-up beschouwt.

Een volledig back-upplan omvat:

- het geconfigureerde `HITKEEP_DB_PATH`;
- het volledige `HITKEEP_DATA_PATH`, inclusief `tenants/*/hitkeep.db`;
- de geconfigureerde archief- en back-uppaden;
- alle externe S3-objecten wanneer die paden `s3://`-URL’s gebruiken.

Zie [Back-ups en herstel](https://hitkeep.com/guides/data/backups-and-restore/) voor herstelprocedures en [S3-back-ups](https://hitkeep.com/guides/data/s3-backups/) voor opslag buiten de machine.

## Opmerkingen voor productie

- Plaats HTTPS voor HitKeep en stel `HITKEEP_PUBLIC_URL` in op exact de URL die in de browser zichtbaar is.
- Configureer [vertrouwde proxy’s](https://hitkeep.com/guides/installation/trusted-proxies/) wanneer verkeer via een reverse proxy of load balancer loopt.
- Voer HitKeep onder een macOS-servicemanager uit als het automatisch moet starten; houd geheimen uit de shellgeschiedenis en argumenten van servicecommando’s.
- Gebruik de [handleiding voor de Linux-binary](https://hitkeep.com/nl/guides/installation/binary/) voor servers op basis van systemd.

[Vorige Overzicht](https://hitkeep.com/nl/guides/installation/)[Volgende Linux-binary](https://hitkeep.com/nl/guides/installation/binary/)