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:

Post-Deploy

Relay is accessible at your Railway public domain
Nostr clients can connect via wss://
Git repos are persisted at /data/git on the relay volume
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