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 single all-in-one Docker container containing the FastAPI backend, SvelteKit web dashboard, GStreamer audio pipeline, and Liquidsoap stream processor.

Requirements

Requirement	Minimum
Docker	24.0 or later
Docker Compose	v2.20 or later
CPU	2 cores (4+ for multiple stations)
RAM	2 GB (4 GB recommended)
Architecture	x86_64 or ARM64
Ports open	8000 (dashboard/API), 8100+ (station harbors), 8005 (Icecast)

Deploy

Get the source

Download and extract the brūhi Cloud release package, then navigate to the directory:
Terminal window
```
cd bruhi-cloud
```
Configure environment
Terminal window
```
cp .env.example .env
```
At minimum, set CORS_ORIGINS to the URL you will access the dashboard from:
```
PORT=8000
LOG_LEVEL=info
CORS_ORIGINS=http://localhost:8000
```
See Self-Hosting for all variables.
Start
Terminal window
```
docker compose up -d
```
Verify
Terminal window
```
curl http://localhost:8000/health
# {"status":"ok"}
```
Open http://localhost:8000 in your browser.