====== Installing and Using Murmur in a Docker Container ======

This assumes you have already installed Docker. For this we are using the backend OS as [[https://www.centos.org/download/|CentOS 7]]. Clicker here for a guide to install [[:docker|Docker]]

----

This is a barebones docker container built using busybox and a statically compiled version of murmurd from the [[https://www.mumble.info/|official website]].

It's configured to look for the configuration file in ''/etc/murmur.ini''.
===== Usage =====

The recommended way to run this container is as follows:
<code>

$ docker run -d -p 64738:64738 -p 64738:64738/udp mattikus/murmur

</code>

To have the container store the sqlite database on your filesystem instead, you can run:

<code>
$ docker run -d -p 64738:64738 -p 64738:64738/udp \
    -v /path/to/data:/data mattikus/murmur

</code>

===== Important notes =====

==== Getting the super-user password ====

On first run, if you don't already have an existing state database, you'll want to look at the logs for your container to get the super-user password:

<code>
$ docker logs murmur 2>&1 | grep Password
<W>2014-07-27 01:41:31.256 1 => Password for 'SuperUser' set to '(mAq3hkwnkD'

</code>

==== Providing your own murmur.ini ====

If you want to tweak the provided murmur.ini, you should run:
<code>

docker cp your-container-name:/etc/murmur.ini /path/to/murmur.ini

</code>

If you are using the built in volume at ''/data/'', then you should sure your config contains:
<code>
database=/data/murmur.sqlite

</code>

To run the container with your tweaked murmur.ini:

<code>
$ docker run -d -p 64738:64738 -p 64738:64738/udp \
    -v /path/to/murmur.ini:/etc/murmur.ini mattikus/murmur

</code>