Ubuntu and Debian based distributions

For Debian, skip the PPA instructions and follow the manual package installation instructions.

Using the Ubuntu PPA

Ubuntu packages are provided in a PPA repository for easy updates. The server is managed as an upstart job on Ubuntu prior 15.04 (Vivid) or as systemd service since Vivid.

First you must ensure that Java 8 or higher is installed:

$java -version
java version "1.8.0_25"
Java(TM) SE Runtime Environment (build 1.8.0_25-b17)
Java HotSpot(TM) 64-Bit Server VM (build 25.25-b02, mixed mode)

If Java is not installed, the easiest way is to install the Oracle Java 8 JRE via the webupd8team PPA:

$sudo add-apt-repository ppa:webupd8team/java
$sudo apt-get update
$sudo apt-get install oracle-java8-installer

Although the Oracle JRE is preferred, the OpenJDK 7 or higher should also work:

$sudo apt-get install openjdk-8-jre-headless

To install the BubbleUPnP Server PPA package:

$sudo add-apt-repository ppa:bubbleguuum/bubbleupnpserver
$sudo apt-get update
$sudo apt-get install bubbleupnpserver

Note: The bubbleupnpserver package may not be available in the PPA if your distro is not an LTS version and too old. In that case, refer to manual package instructions after this section.

Installing the package manually

For Ubuntu versions using systemd (>= 15.04 “Vivid”) or Debian versions using systemd (>= Debian 8 “Jessie”):

$sudo dpkg -i bubbleupnpserver_0.9-5_all.deb

For older versions of Ubuntu or Debian using upstart:

$sudo dpkg -i bubbleupnpserver_0.9-2_all.deb

After install the server should be running. Connect to it with your web browser: http://localhost:58050 (from your Ubuntu machine) or http://:58050 (from another machine on the LAN).


  • the package installs a ffmpeg static binary to provide audio/video transcoding out of the box
  • data files (configuration, log files, playlists, …) are stored in the .bubbleupnpserver subdirectory of the home directory of the user running the server. For root this is /root/.bubbleupnpserver.
  • if using upstart, the user running the BubbleUPnP Server as well as the http ports can be easily changed in /etc/default/bubbleupnpserver (needs a server restart).
  • with upstart, to start BubbleUnP Server: $sudo start bubbleupnpserver
  • with upstart, to stop BubbleUnP Server: sudo stop bubbleupnpserver
  • with systemd (Vivid+), to start BubbleUnP Server: sudo systemctl start bubbleupnpserver
  • with systemd (Vivid+), to stop BubbleUnP Server: sudo systemctl stop bubbleupnpserver

Arch Linux

Install from the package from AUR.

Other distributions

Follow the generic Java platform instructions or install via Optware-ng below.

Optware-ng (hard-float ARMv7, I686, PowerPC 603e and soft-float ARMv5, ARMv7 EABI, MIPSEL and PowerPC e500v2)

Optware-ng is a package repository for many architectures running Linux.

It can be used to install BubbleUPnP Server on any of these platforms, such as: Raspberry Pi, NASes, routers, custom devices, …

Optware-ng provides full featured ffmpeg binaries for use with BubbleUPnP Server, installed alongside the BubbleUPnP Server package.

To install the BubbleUPnP Server package:

  1. launch a command shell
  2. install Optware-ng corresponding to your hardware, following these instructions 3.install the BubbleUPnP Server package: ipkg install bubbleupnpserver-installer
  3. At this point, BubbleUPnP Server should be running. Depending on the CPU speed, it could take up to 2 minutes to fully start. Once fully started, connect to http://ip_address:58050 to configure BubbleUPnP Server (NOTE: connecting to BubbleUPnP Server via https is very slow an unusuable due to an OpenJDK issue. Always connect using http)

BubbleUPnP Server is installed in /opt/share/bubbleupnpserver and this is where the log file is located.

To stop BubbleUPnP Server:

/opt/bin/bubbleupnpserver stop

To start BubbleUPnP Server:

/opt/bin/bubbleupnpserver start

Install ffmpeg binaries with Optware-ng

This step is not necessary if BubbleUPnP Server was installed via Optware-ng.

Many ARM NASes and devices either do not have ffmpeg available or have a version that is outdated and/or missing some features. For example, stock ffmpeg on Synology DSM 6 is missing video transcoding support, and ffprobe (used by BubbleUPnP Server to analyse audio/video) is not bundled.

The solution is to install ffmpeg binaries using Optware-ng. These binaries fully support all BubbleUPnP Server features:

  1. launch a command shell
  2. install Optware-ng corresponding to your hardware, following these instructions
  3. install the ffmpeg package: ipkg install ffmpeg
  4. Restart BubbleUPnP Server to make it automatically pickup Optware-ng’s ffmpeg