> ## Documentation Index
> Fetch the complete documentation index at: https://rockboxzig.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install pre-built binaries or build Rockbox Daemon from source.

The recommended path is to install a pre-built binary for your platform.
Building from source is documented in [Architecture › Build](https://rockboxzig.mintlify.site/architecture/build.md).

## Pre-built binaries

Pre-built packages for the latest release are on the
[Releases page](https://github.com/tsirysndr/rockboxd/releases/latest).

| Platform | Architecture | Package |
| - | - | - |
| Linux | x86\_64 | `.tar.gz` |
| Linux | aarch64 | `.tar.gz` |
| macOS | x86\_64 | `.pkg` |
| macOS | aarch64 (Apple Silicon) | `.pkg` + `.dmg` |

## Package managers

### Ubuntu / Debian

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
echo "deb [trusted=yes] https://apt.fury.io/tsiry/ /" | sudo tee /etc/apt/sources.list.d/fury.list
sudo apt-get update
sudo apt-get install rockbox
```

### Fedora

Add the following to `/etc/yum.repos.d/fury.repo`:

```ini theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
[fury]
name=Gemfury Private Repo
baseurl=https://yum.fury.io/tsiry/
enabled=1
gpgcheck=0
```

Then:

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
sudo dnf install rockbox
```

### macOS (Homebrew)

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
brew install tsirysndr/tap/rockbox
```

### macOS desktop app (Homebrew cask)

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
brew install --cask tsirysndr/tap/rockbox
```

Installs `Rockbox.app` into `/Applications` — the native desktop client with
the daemon embedded, so no separate `rockboxd` process is needed.

### Arch Linux

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
paru -S rockboxd-bin
```

### Universal installer

The installer detects your OS and architecture and drops the right binary
under `/usr/local/bin`:

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
curl -fsSL https://raw.githubusercontent.com/tsirysndr/rockboxd/HEAD/install.sh | bash
```

### Docker

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
docker pull tsiry/rockbox
```

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
docker run --rm -it \
  -p 6060-6063:6060-6063 \
  -p 6600:6600 \
  -p 7878-7881:7878-7881 \
  -p 3483:3483 \
  -p 9999:9999 \
  -p 1704:1704 \
  -p 1705:1705 \
  -p 1780:1780 \
  -v $HOME/Music:/root/Music \
  tsiry/rockbox
```

> [!NOTE]
>
> For AirPlay, Squeezelite and UPnP discovery (mDNS / SSDP) you'll usually want
> `--network host` instead of port mapping — multicast does not cross Docker's
> default bridge network.

## Run as a systemd service

Once `rockbox` is on your `PATH`:

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
rockbox service install    # enable and start
rockbox service status     # check status
rockbox service uninstall  # stop and disable
```

This installs a user-level systemd unit at `~/.config/systemd/user/rockboxd.service`.

## Verifying the install

```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
rockbox --version
rockbox start
```

The daemon binds these ports by default:

| Service | Port | Protocol |
| - | - | - |
| gRPC | 6061 | gRPC / gRPC-Web |
| GraphQL + Web UI | 6062 | HTTP / WS |
| HTTP REST | 6063 | HTTP |
| MPD | 6600 | MPD |

See the full [port reference](https://rockboxzig.mintlify.site/reference/ports.md).

## Building from source

If you want to hack on Rockbox Daemon itself, see
[Architecture › Build](https://rockboxzig.mintlify.site/architecture/build.md) for the Make + Cargo + Zig
toolchain.

## Uninstall

> [accordion] Debian / Ubuntu
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> sudo apt-get remove rockbox
> rockbox service uninstall   # if you installed the systemd unit
> ```

> [accordion] Fedora
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> sudo dnf remove rockbox
> rockbox service uninstall
> ```

> [accordion] Arch
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> sudo pacman -Rns rockboxd-bin
> ```

> [accordion] macOS (Homebrew)
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> brew uninstall rockbox
> ```

> [accordion] macOS desktop app (Homebrew cask)
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> brew uninstall --cask rockbox
> ```

> [accordion] macOS .pkg
>
> ```sh theme={"theme":{"light":"catppuccin-latte","dark":"min-dark"}}
> sudo rm /usr/local/bin/rockbox /usr/local/bin/rockboxd
> sudo pkgutil --forget io.github.tsirysndr.rockbox
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.