Installation

Windows

On Windows, installation is performed by the self-extracting installation wizard. RSAS installs as a background service in Windows, suitable for server environments, but also includes a separate graphical user interface (GUI) application for easy configuration and monitoring.

You can launch the RSAS GUI by looking for the "Rocket Streaming Audio Server" shortcut in your Start menu.

All configuration on Windows should be done through the RSAS GUI.

Linux

Download the latest release for your Linux distribution here.

The Ubuntu / Debian package can be installed with:

$ sudo apt-get install libogg0
$ sudo dpkg -i rsas*.deb

The CentOS / RHEL RPM can be installed with:

$ sudo yum install libogg openssl
$ sudo rpm -U rsas*.rpm

For other Linux distributions, the static binary should work on any recent 64-bit Linux distribution with glibc 2.27 or later:

$ tar -xvzf rsas-1.0.0-linux_amd64.tar.gz
$ cd rsas-1.0.0
$ sudo ./install.sh

As of 1.0, the RSAS Linux packages or install.sh script will create an rsas user account, install the systemd service file, and create any necessary directories in /usr/share/rsas.

Before starting RSAS, you will need to create a config file. If you want to get started quickly, just copy the "Simple Example" from here. Full details on how to create and customize a config file are covered in the Configuration section.

We recommend putting your configuration in /etc/rsas/rsas.xml.

To run RSAS with your configuration, run:

$ rsas -c /etc/rsas/rsas.xml

Alternatively, if you already have a working Icecast configuration, you can load it in RSAS. You can stop your existing Icecast daemon and start RSAS with:

$ sudo service icecast2 stop
$ rsas -c /etc/icecast2/icecast.xml

Pro Edition License Installation

Each Pro Edition license comes with a license.key file that must be installed to activate the Pro Edition.

The license.key file can either be in the current working directory, or in /etc/rsas. We recommend copying it to /etc/rsas:

$ sudo mkdir -p /etc/rsas
$ sudo cp license.key /etc/rsas

Running as a daemon / systemd service

As of version 1.0.0, RSAS installs as a systemd service, but you will still need to "enable" the service so that it starts on boot up.

To enable RSAS to start at boot, run:

$ sudo systemctl enable rsas

Next, start RSAS with:

$ sudo systemctl start rsas

You can check the status of the service to make sure it's running properly, by running:

$ sudo systemctl status rsas

You can also view the error log for it by running:

$ sudo journalctl -u rsas

FreeBSD

Download the latest release for FreeBSD here.

The FreeBSD package can be installed with:

$ tar -xvzf rsas-1.0.4-freebsd12_amd64.tar.gz
$ cd rsas-1.0.4
$ sudo ./install.sh

Application files will be installed into /usr/local/www/rsas. An rc.d init script is installed so that RSAS can run as a service.

You can start the RSAS service with:

$ service rsas start

Upgrading from a pre-1.0 version

Windows

RSAS 1.0+ can be safely installed over any previous version. No additional action is required to upgrade.

Linux

Our DEB and RPM packages have been upgraded to now include the systemd service file and create a separate user/group for RSAS. The bundled systemd service file installs at a different path /usr/lib/systemd/system/rsas.service, so we recommend removing any previously installed one.

For convenience, run the following commands as root after upgrading to RSAS 1.0.0 to normalize your installation:

mv /etc/systemd/system/rsas.service /etc/systemd/system/rsas.service.disabled
systemctl daemon-reload
chown -R rsas:rsas /etc/rsas /usr/share/rsas /var/log/rsas

Restart RSAS if needed, by running systemctl restart rsas.