Installing Starting And Stopping Subsonic
To use Subsonic you must install the Subsonic server on a computer. You must then start the server and a later date you may wish to stop or uninstall the server. This guide will take through how this is done on various different platforms.
At a bare minimum you will need to install a Java runtime environment (Java 1.5 or later). It can be provided by one of the following.
If you want to be able to transcode any of your music then you will need additional tools. The following tools should be adequate for most people
- Subsonic requires LAME for transcoding mp3s to lower bit rate and is used by default to encode mp3s for streaming.
- Subsonic can use ffmpeg to transcode many media formats to mp3 format for streaming.
Please see the Installation section for your platform for help installing these prerequisites.
The pre-built installs are automated installers each for a particular platform. These are generally advised for those who are new Subsonic and that prefer a simple but inflexible set up process. Below are links to pages detailing installation on various different platforms.
- Mac OSX
- Debian, Ubuntu, Mint or any .deb based distribution
- Fedora, Redhat, openSUSE, CentOS or any .rpm based distribution
Stand alone install
The stand alone install is Subsonic with the [Jetty] web server included. Jetty itself runs via Java and is thus can run on any platform that supports the Java run time environment. This type of install is recommended for experienced users who wish for more flexible installation method.
You can install Subsonic as a web application (
subsonic.war) for use with an external server such as Tomcat, Jetty, GlassFish] & Geronimo. The most commonly used server is Tomcat. Below are links to pages describing how to use Subsonic with various different Java servlet servers.
Building from source
Subsonic is open source software licensed under GPLv3. Subsonic is based on Java and so can built on any platform that supports Java 1.5 or greater. Below are links to instructions for compiling and running Subsonic on different platforms.