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.
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
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
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
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
RSAS 1.0+ can be safely installed over any previous version. No additional action is required to upgrade.
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
.