# Self-host

> Run the Weald relay yourself, on a server or on your Mac. Three commands or a signed download, your own keys, and the same protocol as the hosted service.

Source: https://getweald.com/self-host
Last modified: 2026-08-20

---

## Three commands

Open source

## The relay is open source

Apache 2.0.

```sh
git clone https://github.com/Weald-Protocol/wealdrelay
```

## Run it in your account

```sh
curl -fsSL https://get.weald.team/relay | sh
cd weald-relay && cp .env.example .env && $EDITOR .env
docker compose up -d
```

## Give this to your coding agent

Copy this prompt to have an agent install the relay on your server.

```sh
Install a self-hosted Weald Relay on my server. Follow the official guide at https://getweald.com/docs/self-hosting end to end.

First, check the requirements and confirm the server, DNS hostname, and ports 80 and 443 are ready. Install the published Compose bundle, set the hostname in .env, start the relay, and verify it is healthy. Wait for TLS and database migrations to finish.

Do not replace existing services or expose private endpoints. Save the bootstrap invite and genesis fingerprint securely, then tell me what you changed, how you verified it, and what I need to do in the Weald Mac app to create the first workspace. Ask before any destructive change.
```

## Pin the published image

Use a digest.

```sh
ghcr.io/weald-protocol/wealdrelay@sha256:e78268855dd932bb06ce975bacda3fd8df6a4c28aa728838b356b3f61866c117
```

Release · Upgrade

## Verify what runs

Verify · Install · Protocol

## Or host it on your Mac

Menu-bar relay.

*Two ways to host*

| Host | What it takes |
| --- | --- |
| A server or VPS | The commands above, a domain, TLS |
| Your Mac | A signed download, a Docker engine |

macOS 14+. Docker required.