<!-- page:59533 -->
# Homebrew

<!-- block:59318 -->
## Install and start

With [Homebrew](https://brew.sh/) installed, run:

```sh
brew tap wikilayer/tap
brew install wikilayer/tap/wikilayer
brew services start wikilayer/tap/wikilayer
```

The [tap](https://github.com/wikilayer/homebrew-tap) also has a Brewfile if you prefer `brew bundle`. Open [Wikilayer on this Mac](http://localhost:38731), then [connect a local agent](page:59569).

<!-- block:59319 -->
## Data and existing services

The service starts its own PostgreSQL cluster through a private Unix socket and keeps the database and uploads in `$(brew --prefix)/var/wikilayer`. It does not start Homebrew's regular PostgreSQL service. It listens on port 38731, as the [Docker](page:59407) installation does, so stop one before starting the other.

<!-- block:59320 -->
## Maintenance

To update Wikilayer, run:

```sh
brew update
brew upgrade wikilayer/tap/wikilayer
brew services restart wikilayer/tap/wikilayer
```

Check the installed version:

```sh
wikilayer version
```

To back up the database and uploaded files, stop the service, archive its data directory, then start it again:

```sh
brew services stop wikilayer/tap/wikilayer
tar -C "$(brew --prefix)/var" -czf "$HOME/wikilayer-backup-$(date +%Y%m%d-%H%M%S).tar.gz" wikilayer
brew services start wikilayer/tap/wikilayer
```

Uninstalling the formula leaves `$(brew --prefix)/var/wikilayer` in place. Keep a backup before moving to another Mac or changing PostgreSQL major versions.

---

## Links here

- [Docker](page:59407)
- [Move from Wikilayer.org](page:59343)
- [Self-hosted](page:59317)

---

[All pages](https://wikilayer.org/smee-again/wikilayer-howto/en/index.md)