Download the latest prebuilt binary from GitHub Releases, then start it:
tar -zxvf GooseForum_Linux_x86_64.tar.gz
chmod +x ./GooseForum
./GooseForum serveOpen http://localhost:5234. The first registered user automatically becomes the administrator.
Requirements:
- Go 1.26+
- Node.js 18+
- pnpm
git clone https://github.com/leancodebox/GooseForum.git
cd GooseForum
cd resource && pnpm install && pnpm build && cd ..
go mod tidy
go build -ldflags="-w -s" .
./GooseForum serveGooseForum creates config.toml on first startup. The default database is SQLite.
[app]
env = "production"
[server]
port = 5234
url = "http://localhost"
[db.default]
connection = "sqlite"
path = "./storage/database/sqlite.db"See configuration documentation for MySQL, mail, backup, security, and site settings.
./GooseForum set-user-admin <userId>
./GooseForum set-user-email <userId> <email>
./GooseForum set-user-password <userId> <password>GooseForum is a technical community platform built with Go, Gin, GORM, Vue 3, TypeScript, Vite, and TailwindCSS. It ships as a single executable, supports SQLite/MySQL, and provides a payload-driven SPA experience with server-rendered fallback pages for SEO and no-js access.
Live demo: gooseforum.online
- Markdown topics, replies, categories, notifications, chat, drafts, and user profiles.
- Role and permission management with a full admin console.
- Responsive public UI for desktop and mobile.
- Theme workbench for light/dark theme preview and publishing.
- SQLite by default, optional MySQL, scheduled backups.
- Payload-driven navigation with no-js GoHTML templates.
- Brand customization for logo, text, footer, and site assets.
# Backend with hot reload
air
# Public site and admin console
cd resource && pnpm devThe admin console is served by the same Vue app under /admin; it does not require a separate frontend service.
GooseForum/
├── app/ # Backend code
│ ├── console/ # CLI commands
│ ├── http/ # Controllers, middleware, routes
│ ├── models/ # GORM models
│ └── service/ # Business services
├── resource/ # Vue 3 frontend, templates, static assets
│ ├── src/site/ # Public site
│ ├── src/admin/ # Admin console
│ ├── src/runtime/ # Payload runtime and shared browser helpers
│ └── templates/ # GoHTML fallback templates
├── docs/ # Documentation
├── main.go
└── config.toml
For production, place GooseForum behind a reverse proxy such as Nginx or Caddy, enable HTTPS, and configure database backups.
Minimal container image:
FROM alpine:latest
RUN apk --no-cache add ca-certificates
WORKDIR /root/
COPY GooseForum .
CMD ["./GooseForum", "serve"]MIT License. See LICENSE.