Install with Release Package
The release package is the recommended installation method when you do not want to use Docker.
Requirements
- OS: Windows / macOS / Linux
- Memory: 2GB+ recommended
- Database:
- SQLite for local trial and small sites
- MySQL 8+ recommended for production
Download
Releases: https://github.com/mlogclub/bbs-go/releases/latest
| Platform | File |
|---|---|
| Windows | bbs-go-windows-x86_64.zip |
| macOS Intel | bbs-go-macos-amd64.zip |
| macOS Apple Silicon | bbs-go-macos-arm64.zip |
| Linux 64-bit | bbs-go-linux-amd64.zip |
| Linux 32-bit | bbs-go-linux-386.zip |
Package Layout
After extracting a release package, the directory includes the executable and built-in resources:
text
<release-root>/
├── bbs-go
├── res/
├── locales/
└── site/Start BBS-GO
Run from the extracted directory:
bash
# Linux/macOS
./bbs-go
# Windows
bbs-go.exeDefault port: 8082.
First-Time Installation
Open:
text
http://localhost:8082/installInstaller steps:
- Select language (
en-US/zh-CN). - Select database.
- Fill site information.
- Create admin account.
- Complete installation.
For local trial, select SQLite. For production, use MySQL 8+.
Access URLs
- Site:
http://localhost:8082/ - Admin dashboard:
http://localhost:8082/dashboard - API:
http://localhost:8082/api/*
Common Issues
Port Already in Use
Change Port in bbs-go.yaml or stop the conflicting process.
Database Connection Failed
- MySQL: verify host, port, username, password, and database name.
- SQLite: choose SQLite in the installer. No manual database setup is required.