BBS-GO Installation Guide

1. Requirements

• OS: Windows / macOS / Linux
• Memory: 2GB+ recommended
• Database:
  • MySQL 8+ recommended for production
  • SQLite available for local trial

2. Download Release Package

Releases: https://github.com/mlogclub/bbs-go/releases

Platform	File
Windows 64-bit	bbs-go-windows-amd64.zip
Windows 32-bit	bbs-go-windows-386.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

3. Start the Program

Extract package, enter directory, then run:

# Linux/macOS
./bbs-go

# Windows
bbs-go.exe

Default port: 8082.

4. First-Time Installation

Open in browser:

http://localhost:8082/install

Installer steps:

1. Select language (en-US / zh-CN)
2. Select database (MySQL or SQLite)
3. Fill site information
4. Create admin account
5. Finish installation

The system will initialize config and data automatically.

5. Access URLs

• Site: http://localhost:8082/
• Admin: http://localhost:8082/admin

6. Troubleshooting

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 directly in installer (no manual DB setup needed)

Production recommendations

• Use MySQL
• Put Nginx/Caddy in front and enable HTTPS
• Backup database and uploads regularly

7. Advanced Docs

• Installation & Deployment Overview
• Service Deployment