Instalar o HitKeep com Homebrew no macOS e Linux

O Homebrew é a forma suportada mais direta de instalar o HitKeep no macOS com Apple Silicon e no Ubuntu Linux com AMD64 ou ARM64. O tap oficial instala o binário estável atual hitkeep; os dados continuam armazenados localmente e o HitKeep usa a mesma configuração de qualquer outra implementação autoalojada.

Plataforma	Compatibilidade com Homebrew
macOS ARM64 (Apple Silicon)	Validada em CI
Ubuntu Linux AMD64/x86_64	Validada em CI com Linuxbrew
Ubuntu Linux ARM64	Validada em CI com Linuxbrew

A CI de lançamento instala a fórmula estável, atualiza-a para a versão candidata, verifica a versão instalada, executa brew test e desinstala-a em cada uma das plataformas indicadas.

Início rápido

Instale o HitKeep pelo tap oficial:

brew install PascaleBeier/hitkeep/hitkeep
hitkeep --version

Crie diretórios persistentes explícitos, gere um segredo de sessão e inicie uma instância 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

Abra http://localhost:8080 e conclua o assistente de configuração.

Mantenha o segredo da sessão

O comando acima serve para um início rápido local. Antes de depender desta instância, armazene um único HITKEEP_JWT_SECRET estável em um arquivo de ambiente com permissões restritas ou na configuração do serviço. Gerar outro segredo a cada inicialização encerra as sessões dos usuários.

Consulte a Referência de configuração para URLs de produção, e-mail, armazenamento, S3, MCP e configurações opcionais de IA.

Verificar

Em outro terminal, confirme a fórmula instalada, execute o teste da fórmula do tap e verifique as duas sondas de execução:

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

/healthz confirma que o processo está ativo. /readyz confirma que o banco de dados compartilhado e todos os bancos de dados de tenants abertos estão prontos para atender ao tráfego.

Atualizar

Leia as notas da versão, atualize os metadados do Homebrew e a fórmula:

brew update
brew upgrade hitkeep
brew list --versions hitkeep

Reinicie o processo do HitKeep depois da atualização. O Homebrew substitui o executável; ele não move nem exclui os caminhos de dados configurados.

Backup

O início rápido ativa o worker de backup com checkpoints do HitKeep em $HOME/.local/share/hitkeep/backups. Mantenha esse diretório em armazenamento durável e teste uma restauração antes de considerá-lo um backup de produção.

Um plano de backup completo inclui:

• o HITKEEP_DB_PATH configurado;
• todo o HITKEEP_DATA_PATH, incluindo tenants/*/hitkeep.db;
• os caminhos configurados para arquivos e backups;
• os objetos S3 externos quando esses caminhos usam URLs s3://.

Consulte Backups e restauração para os procedimentos de restauração e Backups no S3 para armazenamento fora da máquina.

Observações para produção

• Coloque HTTPS à frente do HitKeep e defina HITKEEP_PUBLIC_URL exatamente como a URL visível no navegador.
• Configure os proxies confiáveis quando o tráfego passar por um proxy reverso ou balanceador de carga.
• Execute o HitKeep com um gerenciador de serviços do macOS se ele precisar iniciar automaticamente; não deixe segredos no histórico do shell nem nos argumentos do comando do serviço.
• Use o guia do binário Linux para servidores com systemd.