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:
- Open a terminal window (
CTRL+ALT+ton Ubuntu and related distros).
- Assuming Jamulus is in
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.
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.
- Download the latest headless .deb file
- Update apt to make sure you have a current list of standard packages:
sudo apt update
- Install the Jamulus package:
sudo apt install ./jamulus_headless_3.8.0_ubuntu_amd64.deb
- Enable the headless server process via systemd:
sudo systemctl enable jamulus-headless
- Add your desired command line options to the
ExecStartline in the systemd service file in
/lib/systemd/system/jamulus-headless.service(By default you will be running a private server).
- Reload the systemd files
sudo systemctl daemon-reloadand restart the headless server:
sudo systemctl restart jamulus-headless
- Check all is well with
service jamulus-headless status(hit
qto get back to the command prompt).
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
To upgrade your server to a newer version, simply download a new .deb and re-install as step 3.
See this information on controlling recordings on headless servers.