JReceiver: Server Install


This is a tutorial describing how to install and configure support for the JReceiver Server on any platform that supports Java 1.3 or later.

The resulting installation can be used to build sophisticated playlists from large music libraries and stream the MPEG data to client players, such as desktop players like Winamp or console players like the Rio Receiver.

This documentation relies on users as yourself to fix errors and contribute tips. Post them to the bug database for the JReceiver project at the SourceForge site so they can be tracked. Thanks.

Prerequisite Installation

None. This is the starting point.

Technical Capability

Following the procedures described in this tutorial should be within the capabilities of anyone who has successfully installed and configured their operating system.


The current implementation of the JReceiver Server requires a platform with a Java runtime (version 1.3 or later), a Java compiler for JavaServer pages, a web servlet container and the MySQL database.

As the project is still early in development, the support is narrow and presently limited to:

  • Java JRE/JDK (1.3.x or newer) from http://java.sun.com
  • Jetty (4.2.9 or newer) from http://jetty.mortbay.com
  • MySQL (3.23 or newer) from http://www.mysql.com

    We've received reports from users that JReceiver can be used with Tomcat/Apache as the servlet/webserver host. Details can be found by searching the jreceiver_user archives.

    JRec is running on Debian, Redhat and SuSE distributions of Linux as well as Windows 2000 and Mac OSX. The present development and documentation effort focuses on Linux. Documentation will remain spotty on other platforms. See the Yahoo group for details on installing on other platforms.

    Broader support will arrive with the release of the first beta, probably later this year.


    If you have a question, it may already be answered here: faq (Latest online: here)

    There is also a troubleshooting help file located here: troubleshooting (Latest online: here)

    You can find support for installation and usage at: http://groups.yahoo.com/group/jreceiver_user. No registration required to browse the message archives.

    If you have a question or experience a problem, please post to this list (req. free registration) rather than contacting the author directly. The author will be monitoring it along with other users who can probably answer your question more promptly.


    Follow these instructions ENTIRELY AT YOUR OWN RISK. While a good faith effort has been made to ensure that these instructions are accurate, you must nevertheless take full responsibility should you damage your system or your network. As a precautionary measure with any installation, you should first back up all your critical data and configuration files.


    JReceiver is a conventional servlet application. As such, those experienced with webapp installation and administration can probably install JRec quickly.

    Most users, however, will never have installed a webapp before. For these neophytes we provide detailed instructions below.

    For best results, follow these sections in sequence:

    1. Java Runtime - all Java apps need one
    2. MySQL - a fast SQL database
    3. Jetty - servlet container
    4. JRec Server - the JReceiver Server
    5. Rio Driver - for Rio owners (Linux docs only)
    6. RedRat2 Driver - for RedRat owners
    As support widens and install docs are written, we'll include them here.


    (in chronological order)

    With thanks to Rob van der Valk, David Schuetz and others for their tips.

    (0.2.0) Big thanks to Mark Harrison for the detailed Windows docs.

    (0.2.1) Thanks for Kevin Hawkins for the further enhancements to the Windows docs.

    Copyright © 2001-2002, Reed Esau & the JReceiver Project (http://jreceiver.sourceforge.net), All Rights Reserved