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 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 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, 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 voor herstelprocedures en S3-back-ups 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 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 voor servers op basis van systemd.