Skip to content

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 rungu

Docker

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:latest

From Source

bash
git clone https://github.com/codecoradev/rungu.git
cd rungu
cargo build --release

# Binary at target/release/rungu
./target/release/rungu serve

Quick Start

  1. Create a project:

    bash
    ./rungu project-add "My App"
  2. Start the server:

    bash
    ./rungu serve --db feedback.db
  3. Open in browser:

    http://localhost:3000
  4. Add OAuth providers (optional — see Configuration):

    bash
    export GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
    export GOOGLE_CLIENT_SECRET=GOCSPX-xxx
    ./rungu serve

Next Steps