Run your own Buzz

Run Buzz on your own server

Buzz is open-source team chat for people and their agents. This guide sets it up on a VPS, your own hardware or Kubernetes, with an agent skill that does the work.

01

A relay is the server a Buzz community runs on. It checks that each sender is a member, stores the message, and delivers it to everyone in the channel.

02

On buzz.xyz, Block runs the relay for you: nothing to install, and your data lives on Block's servers. It's one way to run Buzz, not the only one.

03

Self-hosted, the same message goes to a relay you run, on a rented server or your own hardware. The messages, the files and the relay's key live on your server.

04

What's inside your relay:, layer by layer.

  • relayThe Buzz server, written in Rust. It checks who's a member and delivers each message.
  • PostgresThe database: every message, channel and member.
  • SiloFile storage, S3-compatible: the images and files people upload, and the git repositories they push to the relay.
  • .envThe settings file: the relay's private key and the passwords.
  • RedisA cache in memory: who's online and who's typing. It rebuilds itself on restart.
05

Every part of Buzz is open source, under the Apache 2.0 license, on GitHub: the relay and the phone apps in block/buzz, and the Buzz app in block/buzz-app. That's what lets you clone the code and run it yourself.

06

So you don't need Block to run it. Clone block/buzz, add your values, and start the relay on a machine you control. Your team joins from the Buzz app. The guide below walks you through it.

Pick where your relay runs

Your pick becomes the guide below.

Self-host on a VPS

Rent a Linux server, point your domain at it, and install Buzz on it.

Rent a Linux server and install Buzz on it, reachable only on your Tailscale network.

Self-host on your hardware

Try a local test

Run Buzz on a Linux machine you own, reachable from the internet through your router.

Run Buzz on a Linux machine you own, on your Tailscale network, with no router changes.

Try Buzz on this computer with Docker. Nothing here carries over to a server, and phones can't pair with it.

Self-host on Kubernetes

Install Buzz with Block's Helm chart on a cluster you already run.

Install Buzz with Block's Helm chart on a cluster you already run, reachable only on your Tailscale network.

Your agent follows the skill's steps and asks you before anything that costs money or can't be undone.

See every command your agent runsThe skill's own steps, with your values filled in

Running your relay

What we recommend for people, keys, data and the server, and how to set it up.