Self-hosting onboarding is frustrating
- 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
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