← Back to landing
Self-host

Install Riffado

One command on a machine with Docker and Compose v2. The installer pulls the latest release's docker-compose.yml and env.example, generates secrets, starts the stack, and waits on /api/health.

Latest release

View raw script →
~/riffado
$ curl -fsSL https://riffado.com/install.sh | sh

Pin to a specific version

~/riffado
$ curl -fsSL https://riffado.com/v0.5.6/install.sh | sh

Replace v0.5.6 with any released tag from the releases page.

Requirements

  • Linux or macOS
  • Docker (any modern version)
  • Docker Compose v2
  • Outbound HTTPS to GitHub

What the script does

  • Verifies Docker + Compose v2
  • Downloads docker-compose.yml + env template
  • Generates BETTER_AUTH_SECRET, ENCRYPTION_KEY, POSTGRES_PASSWORD
  • Starts the stack, waits on /api/health

Don't want to pipe to shell?

Fair. Read the source at scripts/install.sh on GitHub, or follow the manual self-host instructions in the README. The whole project is AGPL-3.0, inspect everything before you run it.