---
title: "Deploy Buzz Relay"
description: "Nostr relay with built-in Git hosting. Auto-wired Postgres, Redis, MinIO."
category: "AI/ML"
url: https://railway.com/deploy/buzz-relay-2
---

# Deploy Buzz Relay

Nostr relay with built-in Git hosting. Auto-wired Postgres, Redis, MinIO.

**[Deploy Buzz Relay on Railway](https://railway.com/template/buzz-relay-2)**

- **Creator:** INAPP
- **Category:** AI/ML
- **Total deploys:** 1

## Template content

### relay

- **Source:** https://github.com/INAPP-Mobile/railway-buzz-relay
- **Health check:** /_readiness
- **Public domain:** Yes

### redis

- **Source:** https://github.com/INAPP-Mobile/railway-buzz-relay
- **Start command:** `redis-server --appendonly yes`

### minio

- **Source:** https://github.com/INAPP-Mobile/railway-buzz-relay
- **Start command:** `sh -c "mkdir -p /data/buzz-media && exec minio server /data --address :8080 --console-address :9001"`
- **Health check:** /minio/health/live

### postgres

- **Source:** https://github.com/INAPP-Mobile/railway-buzz-relay

## Documentation

# Deploy and Host

## About Hosting

Buzz Relay is a Nostr relay with built-in Git hosting over Nostr (NIP-89). It lets you push and pull Git repositories through the Nostr protocol, with media uploads stored on S3-compatible object storage.

## Why Deploy

- **One-click Nostr relay** — fully configured with auto-generated secrets
- **Git over Nostr** — push/pull repos via NIP-89 compatible clients
- **Media storage** — S3-compatible object storage for blobs and attachments
- **Zero-config** — all credentials auto-generated, services auto-wired

## Common Use Cases

- Self-hosted Nostr relay for personal or community use
- Git repository hosting over the Nostr protocol
- Decentralized code collaboration with Nostr identity
- Media storage for Nostr events and attachments

## Dependencies for Buzz Relay

### Deployment Dependencies

- **PostgreSQL** — database for relay state and metadata
- **Redis** — pub/sub cache for real-time event distribution
- **MinIO** — S3-compatible object storage for media uploads

## Services

| Service | Image | Purpose |
|---------|-------|---------|
| `relay` | ghcr.io/block/buzz:main | Nostr relay (buzz-relay binary) |
| `postgres` | postgres:16-alpine | Database for relay state |
| `redis` | redis:7-alpine | Pub/sub cache |
| `minio` | minio/minio | S3-compatible media storage |

## Environment Variables

All variables auto-populated from companion services:

| Variable | Source | Description |
|----------|--------|-------------|
| `DATABASE_URL` | postgres | PostgreSQL connection URL |
| `REDIS_URL` | redis | Redis connection URL |
| `BUZZ_S3_ENDPOINT` | minio | S3 endpoint for media |
| `BUZZ_S3_ACCESS_KEY` | minio | S3 access key |
| `BUZZ_S3_SECRET_KEY` | minio | S3 secret key |
| `BUZZ_RELAY_PRIVATE_KEY` | auto-generated | Nostr relay signing key |

## Architecture

```
                   +----------------------+
                   |       relay          |
                   |   ghcr.io/block/buzz |
                   |   :main              |
                   +------+---------------+
                          |
          +---------------+---------------+
          |               |               |
   +------+------+ +-----+------+ +------+------+
   |   postgres   | |   redis    | |    minio    |
   |  postgres:16 | |  redis:7   | |   minio     |
   +--------------+ +------------+ +-------------+
```

## Health Checks

- Relay: `/_readiness` on port 8080
- Postgres: built-in
- Redis: `redis-cli ping`
- Minio: `/minio/health/live`

## Deployment

Click the button below to deploy. No configuration needed:

[![Deploy on Railway](https://railway.app/button.svg)](https://railway.com/deploy/_UELh2)

## Post-Deploy

1. Relay is accessible at your Railway public domain
2. Nostr clients can connect via `wss://`
3. Git repos are persisted at `/data/git` on the relay volume
4. Media uploads go to the MinIO bucket

## Notes

- Default database credentials: `postgres` / `postgres` (rotate in dashboard before production)
- Default Redis password: `redis` (rotate in dashboard before production)
- Default MinIO credentials: `minioadmin` / auto-generated password (rotate in dashboard before production)
- Nostr relay private key is auto-generated on first deploy


## 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-relay-2