Installation
Prerequisites
- Rust 1.86+ (recommended: use rustup)
- Node.js 22+ (only needed for frontend development)
Download Binary
Download from GitHub Releases:
bash
# Linux (x86_64)
curl -fsSL https://github.com/codecoradev/rungu/releases/latest/download/rungu-linux-amd64 -o rungu
chmod +x rungu
# macOS (Apple Silicon)
curl -fsSL https://github.com/codecoradev/rungu/releases/latest/download/rungu-darwin-arm64 -o rungu
chmod +x runguDocker
bash
docker pull ghcr.io/codecoradev/rungu:latest
docker run -d \
-p 3000:3000 \
-v rungu-data:/data \
-e APP_SECRET=your-secret-here \
-e GOOGLE_CLIENT_ID=xxx \
-e GOOGLE_CLIENT_SECRET=xxx \
ghcr.io/codecoradev/rungu:latestFrom Source
bash
git clone https://github.com/codecoradev/rungu.git
cd rungu
cargo build --release
# Binary at target/release/rungu
./target/release/rungu serveQuick Start
Create a project:
bash./rungu project-add "My App"Start the server:
bash./rungu serve --db feedback.dbOpen in browser:
http://localhost:3000Add OAuth providers (optional — see Configuration):
bashexport GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com export GOOGLE_CLIENT_SECRET=GOCSPX-xxx ./rungu serve
Next Steps
- Configuration — all ENV variables
- Auth Setup — Google, GitHub, Keycloak
- CLI Reference — all commands
- Docker Guide — Docker Compose setup