Installation

import { Tabs, TabItem, Steps } from ‘@astrojs/starlight/components’;

brūhi Desktop

brūhi Desktop is a native application for macOS, Windows, and Linux. Minimum window size is 1280 × 768.

Requirements

Requirement	Minimum
macOS version	12 Monterey or later
Architecture	Apple Silicon (M1+) or Intel x86_64
RAM	4 GB (8 GB recommended for DSP-heavy use)
Disk	150 MB for the app; additional space for your media library

Install

Download the latest .dmg from bruhi.in/download.
Open the .dmg and drag brūhi to your Applications folder.
On first launch, macOS may show a security prompt — open System Settings → Privacy & Security and click Open Anyway.

Requirements

Requirement	Minimum
Windows version	Windows 10 (64-bit) or later
Architecture	x86_64
RAM	4 GB (8 GB recommended)
Disk	150 MB
Audio	Any WASAPI-compatible audio device

Install

Download the latest .msi or .exe installer from bruhi.in/download.
Run the installer and follow the prompts.
brūhi is installed per-user by default. No administrator rights required.

Requirements

Requirement	Minimum
Distribution	Ubuntu 22.04 / Fedora 38 or equivalent
Architecture	x86_64
RAM	4 GB
Audio	ALSA (default) or JACK

Install from package

# Debian / Ubuntu
sudo dpkg -i bruhi_0.12.0_amd64.deb

# Fedora / RHEL
sudo rpm -i bruhi-0.12.0-x86_64.rpm

# AppImage (any distro)
chmod +x bruhi-0.12.0-x86_64.AppImage
./bruhi-0.12.0-x86_64.AppImage

JACK audio (optional)

brūhi uses ALSA by default. If you prefer JACK:

# Install JACK
sudo apt install jackd2              # Debian/Ubuntu
sudo dnf install jack-audio-connection-kit  # Fedora

# Start JACK before launching brūhi
jackd -d alsa -r 48000 &

brūhi auto-detects JACK when it is running. No extra configuration is needed.

brūhi Cloud

brūhi Cloud runs as a containerized stack containing the FastAPI backend, SvelteKit web dashboard, native bruhi-audio Rust stream engine, and bundled Icecast server.

Requirements

Requirement	Minimum
Docker	24.0 or later with Docker Compose plugin
CPU	2 cores (4+ for multiple stations)
RAM	2 GB (4 GB recommended)
Architecture	x86_64 or ARM64 (AWS Graviton, Apple Silicon, etc.)
Ports open	8000 (dashboard/API), 8010 (Icecast), 8100+ (station harbors), 80/443 (HTTPS)

Quick Deploy (One-Line Installer)

The recommended way to deploy brūhi Cloud on any Linux server (AWS EC2, Lightsail, DigitalOcean, Hetzner, Linode) is the automated interactive install script:

bash <(curl -fsSL https://raw.githubusercontent.com/bruhi-technologies/bruhi-deploy/main/install.sh)

The installer guides you through domain configuration, auto-generates secure streaming passwords, downloads docker-compose.yml and Caddyfile, and pulls the latest Docker image.

Once complete, start the stack:

cd ~/bruhi-cloud
docker compose up -d

Manual Docker Compose Deploy

Download Deployment Configuration

mkdir -p ~/bruhi-cloud && cd ~/bruhi-cloud
curl -fsSL https://raw.githubusercontent.com/bruhi-technologies/bruhi-deploy/main/docker-compose.yml -o docker-compose.yml
curl -fsSL https://raw.githubusercontent.com/bruhi-technologies/bruhi-deploy/main/Caddyfile -o Caddyfile
curl -fsSL https://raw.githubusercontent.com/bruhi-technologies/bruhi-deploy/main/.env.example -o .env

Configure Environment

Edit .env and set your domain name and secure passwords:

COMPOSE_PROFILES=bundled-icecast,proxy
DOMAIN=radio.yourdomain.com
BRUHI_URL=https://radio.yourdomain.com
BRUHI_RP_ID=radio.yourdomain.com

See Self-Hosting Guide for the complete variable reference.

Start the Stack
Terminal window
```
docker compose up -d
```
Verify Health
Terminal window
```
curl http://localhost:8000/healthz
# {"status":"ok"}
```
Open https://radio.yourdomain.com (or http://your-server-ip:8000) in your browser to complete the first-time setup wizard.