block / block/buzz

Self-hosting onboarding is frustrating

Open
#3,088 13 comments 3 reactions 0 assignees View on GitHub
Dominant language
Rust
Stars
32.7k
Forks
4.3k
Avg merge
1d 13h
Merged PRs (30d)
253

Description

I spent some time trying to set up Buzz on a Ubuntu server on my LAN, and the onboarding experience and documentation currently make this very difficult.

The architecture is really interesting, but the current documentation assumes everything is being run on localhost with the Desktop App. Please consider adding a clear "Self-Hosting / LAN Setup" guide, documenting the required environment variables, and explaining the manual git setup for those who just want to use the CLI and a web browser.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the current onboarding documentation and the existing localhost/Desktop App setup instructions. Identify the environment variables and manual git steps needed for an Ubuntu LAN server used through the CLI and a web browser; done means a newcomer can follow a clear self-hosting guide without assuming localhost or the Desktop App.

Written by the indexing model from the issue text.

Assessment

Tech stack
git, ubuntu
Domain
cli, documentation, networking
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
66/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.