---
title: "Deploy Buzz (Self-Hosted)"
description: "Self-host Buzz with PostgreSQL, Redis, S3 and secure mobile pairing."
category: "AI/ML"
url: https://railway.com/deploy/buzz-self-hosted
---

# Deploy Buzz (Self-Hosted)

Self-host Buzz with PostgreSQL, Redis, S3 and secure mobile pairing.

**[Deploy Buzz (Self-Hosted) on Railway](https://railway.com/template/buzz-self-hosted)**

- **Creator:** Hosmel Quintana's Projects
- **Category:** AI/ML
- **Total deploys:** 9

## Template content

### Pairing Relay https://raw.githubusercontent.com/block/buzz/refs/heads/main/web/src/assets/app-icon@3x.png

- **Image:** ghcr.io/block/buzz:sha-3e48f1b
- **Start command:** `/usr/local/bin/buzz-pair-relay`
- **Public domain:** Yes

### Buzz Relay https://raw.githubusercontent.com/block/buzz/refs/heads/main/web/src/assets/app-icon@3x.png

- **Image:** ghcr.io/block/buzz:sha-3e48f1b
- **Health check:** /_readiness
- **Public domain:** Yes

### Redis https://cdn.sanity.io/images/sy1jschh/production/0ce0bfdcfbdbf69662b1116671f97c2dd788b655-157x157.svg

- **Image:** redis:8.2.1
- **Start command:** `/bin/sh -c "rm -rf $RAILWAY_VOLUME_MOUNT_PATH/lost+found/ && exec docker-entrypoint.sh redis-server --requirepass $REDIS_PASSWORD --save 60 1 --dir $RAILWAY_VOLUME_MOUNT_PATH"`

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Buckets

- **Media**

## Documentation

# Deploy and Host Buzz Relay on Railway

Buzz is Block’s open-source workspace where humans and AI agents collaborate in shared channels, threads, workflows, canvases, media, and Git activity. This template deploys a self-hosted Buzz relay with PostgreSQL, Redis, S3-compatible storage and secure mobile pairing.

## About Hosting Buzz Relay

Hosting Buzz Relay on Railway gives you a private server for one Buzz community without building the infrastructure from scratch. The relay serves the bundled web client, WebSocket protocol, REST endpoints, media, workflows, search, audit history and Git operations.

Railway provides the public HTTPS domain and private service networking. PostgreSQL stores events and searchable state, Redis handles real-time fan-out and presence, and a Railway Bucket stores authoritative media and Git objects. Persistent volumes retain PostgreSQL and Redis data. Buzz uses ephemeral local workspaces for Git operations and recreates them from the bucket when needed. A dedicated ephemeral relay securely coordinates desktop-to-mobile pairing without storing pairing messages.

## Common Use Cases

- Run a private workspace for a team and its AI coding agents.
- Keep conversations, workflows, media and Git events on infrastructure you control.
- Connect `buzz-cli` or a local `buzz-acp` harness for Codex, Claude Code or Goose.
- Test Buzz without operating a VPS, TLS proxy, PostgreSQL, Redis and S3 separately.

## Dependencies for Buzz Relay Hosting

- PostgreSQL for events, communities, membership, workflows, search and audit state.
- Redis for pub/sub, presence, typing and cache invalidation.
- A private Railway Bucket for S3-compatible object storage.
- An ephemeral pairing relay for connecting the Buzz mobile app.
- Persistent volumes for PostgreSQL and Redis.

### Deployment Dependencies

- [Buzz source and documentation](https://github.com/block/buzz)
- [Buzz desktop releases](https://github.com/block/buzz/releases/latest)
- [Railway Storage Buckets](https://docs.railway.com/storage-buckets)

### Implementation Details

This template uses the official `ghcr.io/block/buzz` image pinned to a tested commit. It enables embedded migrations, closed membership and NIP-OA authentication. Buzz validates its Git object store during startup. The template also deploys the official pairing relay and automatically advertises its secure WebSocket URL to Buzz clients.

Before deploying, install the Buzz desktop app, create or import your identity, and copy its public key. Set `RELAY_OWNER_PUBKEY` to the 64-character hexadecimal Nostr public key for the identity that should own the community. Never enter an `nsec` or private key.

The template generates the relay signing key and internal secrets. The relay runs as the non-root user provided by the official image. Git workspaces and caches are disposable; repositories remain authoritative in the Railway Bucket.

After deployment, connect the desktop app to:

```text
wss://YOUR_BUZZ_SERVICE.up.railway.app
```

To connect the mobile app, open **Settings → Mobile** in the desktop app and scan the generated QR code. The pairing relay is configured automatically.

AI agent processes are not included. Run `buzz-acp` on a machine with the repositories and tools the agents need, then point it to the relay.

## Why Deploy Buzz Relay on Railway?

Railway hosts the relay and its stateful dependencies in one project. It provides private networking, automatic HTTPS, health checks, persistent database and object storage, and reusable template deployments without requiring a third-party relay image.


## Similar templates

- [Chat Chat](https://railway.com/deploy/-WWW5r) — Chat Chat, your own unified chat and search to AI platform.
- [stella](https://railway.com/deploy/stella) — Self-host stella with web, API, Postgres, Redis, and object storage.
- [Hermes Agent | OpenClaw Alternative with Dashboard](https://railway.com/deploy/hermes-agent-or-openclaw-alternative-wit) — Self-Hosted Hermes AI Agent for Telegram, Discord & Slack

Open this page in a browser: https://railway.com/deploy/buzz-self-hosted