---
title: "Instalar o HitKeep com Homebrew no macOS e Linux | HitKeep"
description: "Instala, verifica e atualiza o HitKeep e cria cópias de segurança do HitKeep no macOS ARM64 ou Ubuntu Linux AMD64 e ARM64 com o tap oficial do Homebrew."
canonical: "https://hitkeep.com/pt/guides/installation/homebrew/"
---

# 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](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](https://hitkeep.com/reference/configuration/) 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](https://github.com/PascaleBeier/hitkeep/releases/latest), 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](https://hitkeep.com/guides/data/backups-and-restore/) para os procedimentos de restauração e [Backups no S3](https://hitkeep.com/guides/data/s3-backups/) 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](https://hitkeep.com/guides/installation/trusted-proxies/) 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](https://hitkeep.com/pt/guides/installation/binary/) para servidores com systemd.

[Anterior Visão geral](https://hitkeep.com/pt/guides/installation/)[Próximo Binário Linux](https://hitkeep.com/pt/guides/installation/binary/)