Jamulus Icon. Links to homepage
Open navigation

Server Installation - Linux

Please ensure you have read the server overview

Running a server with a GUI on a desktop machine

If you have installed the Jamulus client, you can run it in your chosen server mode by running Jamulus with the -s option as follows:

  1. Open a terminal window (CTRL+ALT+t on Ubuntu and related distros).
  2. Assuming Jamulus is in /usr/local/bin, type Jamulus -s

Hit return and you should see the server control window. You can stop the server by closing the server window, or by using CTRL+C in the terminal.

To configure the server, please refer to the Windows & macOS instructions, and Command Line Options for other parameters you can set.

Running a “headless” server

The following is for running Jamulus as a “pure” server on hardware without audio (e.g. on a 3rd party/cloud host) and assumes Ubuntu/Debian distributions using systemd. We also have instructions for Raspberry Pi.

  1. Download the latest headless .deb file
  2. Update apt to make sure you have a current list of standard packages: sudo apt update
  3. Install the Jamulus package: sudo apt install ./jamulus_headless_3.8.0_ubuntu_amd64.deb
  4. Enable the headless server process via systemd: sudo systemctl enable jamulus-headless
  5. Add your desired command line options to the ExecStart line in the systemd service file in /lib/systemd/system/jamulus-headless.service (By default you will be running a private server).
  6. Reload the systemd files sudo systemctl daemon-reload and restart the headless server: sudo systemctl restart jamulus-headless
  7. Check all is well with service jamulus-headless status (hit q to get back to the command prompt).

Notes

You can control Jamulus with the service command. For example, to stop the server cleanly:

sudo service jamulus-headless stop

Viewing The Logs

Jamulus will log to the system file if you left the StandardOutput=journal setting in the unit file. Logging to the system log is recommended, as the system will manage the log file for you - no need to come back and purge it later or worry about filling up your disk space.

To view the log, use journalctl (to exit press Ctrl-C). For example, to read the system log file, filtered for the Jamulus service:

journalctl -u jamulus-headless

For today’s entries:

journalctl -u jamulus-headless --since today

For the last hour:

journalctl -u jamulus-headless --since "1 hour ago"

Filter the log to see connection messages for your Jamulus server:

journalctl -u jamulus-headless | grep connected

Follow (show on screen) Jamulus log messages as they occur:

journalctl -f -u jamulus-headless

Upgrading

To upgrade your server to a newer version, simply download a new .deb and re-install as step 3.

Recording

See this information on controlling recordings on headless servers.

Tell us about Jamulus - take our anonymous survey!

This documentation is licensed under a Creative Commons Licence. Want to get involved?