1. Overview
2. Module Description - What the module does and why it is useful
3. Setup - The basics of getting started with subsonic
   • Beginning with subsonic
4. Usage - Configuration options and additional functionality
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Subsonic is an Open-source web-based media streamer and jukebox. It Supports MP3, OGG, AAC and other streamable audio and video formats.

This Puppet module will install and configure Subsonic.

include '::subsonic' is enough to get you up and running. If you wish to specify parameters to use, then:

class { 'subsonic':
    max_memory => '256',
}

Here is a complete example with all available parameters to configure Subsonic:

class { 'subsonic':
    home         => '/var/subsonic',
    host         => '127.0.0.1',
    http_port    => '2020',
    https_port   => '0',
    context_path => '/',
    max_memory   => '150',
    pidfile      => '/var/run/subsonic',
    user         => 'root',
}

See subsonic --help for more informations about default parameters

• home The directory where Subsonic will create files. Default: /var/subsonic
• host The host name or IP address on which to bind Subsonic. Default: 0.0.0.0
• http_port The port on which Subsonic will listen for incoming HTTP traffic. Default: 4040
• https_port The port on which Subsonic will listen for incoming HTTPS traffic. Default: 0 (disabled)
• context_path The last part of the Subsonic URL. Default: /
• max_memory The memory limit (max Java heap size) in megabytes. Default: 150
• pidfile Write PID to this file. Default: not created.
• user The user to run Subsonic. Default: root

puppetm-subsonic module has been tested on RedHat, Debian and Ubuntu distribution. Adding support for other systems is a matter of defining the relevant parameters in params.pp. So this is really easy for someone with access to such a system.

Patches to support any of these (or other) missing features are welcome.

Contributions are welcome :)