Installation & Deployment
Recommended Mode (All-in-One)
The public release is all-in-one:
bbs-goexecutableres/built-in resources- prebuilt web static assets (bundled in release package)
One process serves:
- Frontend:
/ - Admin:
/admin - API:
/api/*
Release Package Layout
After extracting a release package, the layout is typically unified (no separate frontend/backend source deployment):
text
<release-root>/
├── bbs-go
├── res/
├── locales/
├── site/ # prebuilt frontend static assets
└── admin/ # prebuilt admin static assetsInstallation Flow
- Download a release package (recommended)
- Extract package
- Start
bbs-go - Open
http://<host>:8082/installon first run - Complete database and admin initialization in the installer
Cross-Platform Release Packages
| Platform | File |
|---|---|
| Windows x64 | bbs-go-windows-amd64.zip |
| Windows x86 | bbs-go-windows-386.zip |
| macOS Intel | bbs-go-macos-amd64.zip |
| macOS Apple Silicon | bbs-go-macos-arm64.zip |
| Linux x64 | bbs-go-linux-amd64.zip |
| Linux x86 | bbs-go-linux-386.zip |
Releases: https://github.com/mlogclub/bbs-go/releases
Build from Source (Optional)
If you compile from the public source repository:
bash
go mod download
go build -o bbs-go main.goNote: The open-source repository is prepared by an internal publishing flow (
scripts/main.go). End users do not need to run that script.
Requirements
- Go 1.23+ (only required for source compilation)
- Database:
- MySQL 8+ is recommended for production
- SQLite is supported for local trial (choose in installer)
