Jamulus Icon. Links to homepage
Open navigation

Installation for Linux

Make sure you read the Getting Started page.

Upgrading? You may want to back up your configuration first.

Installing a server? Read the guide for server adminstrators first.

Debian and Ubuntu

We provide a repository for Debian and Ubuntu based distributions that allows automatic updates alongside your other system updates. To use the repository:

  1. Open your Terminal (CTRL+ALT+T should work)
  2. Ubuntu only - Enable the Ubuntu “universe” repository (you can use the GUI-based approach or CLI-based approach).
  3. Download the repository setup script:
    curl https://raw.githubusercontent.com/jamulussoftware/jamulus/main/linux/setup_repo.sh > setup_repo.sh
    
  4. Make the script executable:
    chmod +x setup_repo.sh
    
  5. Run the setup script and install Jamulus:
    sudo ./setup_repo.sh && sudo apt install jamulus
    

Installing the .deb files manually

  1. Download Jamulus for your architecture: amd64, armf or arm64
  2. Ubuntu only - Enable the Ubuntu “universe” repository (you can use the GUI-based approach or CLI-based approach).
  3. Update apt by opening a console window (CTRL+ALT+T should work) and type: sudo apt-get update
  4. Go to where you downloaded the installer and either double-click on it, or use the command line: sudo apt install ./jamulus_3.10.0_ubuntu_amd64.deb (or for Raspberry Pi etc. as above)
  5. Once installed, you can delete the file and close any console windows.

Upgrades: If you need to upgrade Jamulus to a newer version and install Jamulus manually, just download the new .deb file and re-install as above.

Other distributions

For installers on other distributions, see their package managers and Repology. If an up-to-date version of Jamulus is not included in your distribution, you can compile Jamulus from source. Note also the contributed installation scripts.

Set up your hardware

Configure JACK with QjackCtl

Jamulus Clients need JACK to run, but you need to configure that first. The recommended method is to use QjackCtl.

  1. Launch QjackCtl. You will see the Qt JACK Control utility main page
  2. Configure your audio hardware as follows (the exact settings for JACK will depend on what your audio hardware 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

Start Jamulus

With JACK running and configured, launch Jamulus.

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.

All installed?

Take a look at the

Getting Started page