Puppet module to install and configure Subsonic.

Julien Georges



6,215 latest version

4.5 quality score

Version information

  • 0.1.0 (latest)
released Jul 30th 2015
This version is compatible with:
  • RedHat, CentOS, Debian, Ubuntu

Start using this module


GiooDev/subsonic — version 0.1.0 Jul 30th 2015


Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started 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.

Module Description

This Puppet module will install and configure Subsonic.


Beginning with 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         => '',
    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:
  • 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 :)