Installation for Linux
Make sure you read the Getting Started page.
Although we don’t provide official packages for every Linux distribution, you might find Jamulus in the package manager of your distro. Have a look at this table:
There is also list of unofficial packages for different distributions here.
Debian and Ubuntu
You can install Jamulus from buster-backports or - if you’re on amd64 Debian/Ubuntu - you may try the compiled .deb packages from GitHub Actions:
- Download the latest .deb file
- Update apt:
sudo apt-get update
- Install the package:
sudo apt install /path/to/jamulus_3.7.0_ubuntu_amd64.deb.
- Since Jamulus needs the JACK server, you have to install it too. We recommend to use
QjackCtlto configure JACK. You can install it via
sudo apt-get install qjackctl
Afterwards you should look at the “Set up your sound card” step on this page.
If you can’t use one of the above options, you need to compile Jamulus from source:
Compile from source
Get Jamulus sources
- Open up a terminal window (command line -
CTRL+ALT+Ton Ubuntu and related distros)
- Download and unzip the sources for the latest release:
wget https://github.com/jamulussoftware/jamulus/archive/latest.tar.gz tar -xvf latest.tar.gz
First, update your package list (e.g. on Debian-based distributions with
sudo apt-get update).
On Ubuntu-based distributions 18.04+, Debian 9+ or 10 and Raspberry Pi Raspbian Buster release or later:
sudo apt-get install build-essential qt5-qmake qtdeclarative5-dev qt5-default qttools5-dev-tools libjack-jackd2-dev
sudo dnf install qt5-qtdeclarative-devel jack-audio-connection-kit-dbus libQt5Concurrent5 jack-audio-connection-kit-devel
QjackCtl: Optional, but recommended
QjackCtl is a utility to help you set up the JACK audio server (installed as part of the dependencies above). Install it via e.g.
sudo apt-get install qjackctl
You may also wish to consider using a low-latency kernel (e.g. for Ubuntu 18.04:
sudo apt-get install linux-lowlatency-hwe-18.04).
Compile this bad boy
cd into the jamulus sources directory you downloaded:
Now compile the sources with the following commands (the last
make may take several minutes to run):
qmake Jamulus.pro make clean make sudo make install
Note: The compiled version of Jamulus puts itself into
You can now delete the sources directory you compiled from.
Set up your sound card
Configure JACK with QjackCtl
Jamulus clients need JACK to run, but you need to configure that first. The recommended method is to use
- Open the command shell e.g. with Ctrl-Alt-T and
- Execute the command
qjackctl. You will see the Qt JACK Control utility main page
- Configure your audio interface as follows (the exact settings for JACK will depend on what your audio interface/sound card is capable of):
- Set the audio Interface to the one you want (there may be several in the list)
- Set the Sample Rate to 48000
- Set the Frames/Period to 128 and Periods/Buffer at 2 at first
Restart JACK for the new settings to take effect
From the command line, execute the command
jamulus, or if you compiled from source
Jamulus with a (with a capital ‘J’). This will start the Jamulus Client.
If you get problems with sound breaking up (in particular XRUN errors reported by JACK/QjackCtl) try setting bigger values (e.g. 256 frames or 3 periods). Lower ones (e.g. 64 frames) could bring better performance but maybe more sound problems. See the troubleshooting page otherwise.
Jamulus has been installed and can be used now. You can now take a look at the
To update your installation to a new release
Notes for geeks
The “make clean” command is essential to remove the automatically generated Qt files which are present in the .tar.gz file and may not match the Qt version you are using.
To use an external shared OPUS library instead of the built-in one use qmake
To use this file configure the software with
qmake "CONFIG+=noupcasename" Jamulus.proto make sure the output target name of this software is jamulus instead of Jamulus.
Users of Raspberry Pi: You may want to compile the client on another machine and run the binary on the Raspberry Pi. In which case the only libraries you need to run it are those for a headless server build, but with the JACK sound packages. In particular, have a look at the footnote for the headless build.
As of version 3.5.3, Jamulus is no longer compatible with Qt4.