KooZic uses Python 3.5 (or 3.6), relies on PostgreSQL as a database system and FFmpeg for music transcoding. It uses as a core system the Odoo software.

KooZic is being extensively and exclusively tested on Ubuntu 16.04. However, it should work on any Linux distribution without much trouble. In case of problem, check the Odoo installation guide, as well as the FFmpeg documentation. Windows is not supported, while it should be possible to make it work on OSX.

A Docker image is available and provides an up and running installation without hassle. It should work on any Docker-supported platform (including Windows).

Automatic installation

An installation script is provided to automatize installation, un-installation and upgrade.


In a terminal, run the following:

curl >
chmod +x
sudo ./ install

Access KooZic in your browser at http://localhost:8069. The default login and password is “admin”. Change the password right away!.

Okay, now the details…

The installation script takes 2 optional arguments:

  • -u: user (default: root)
  • -d: install directory (default: /opt)

It is advised to use another user than root. Just make sure the user has access to the media folders.

The script will:

  • Retrieve the latest version
  • Install all the dependencies
  • Setup PostgreSQL
  • Install FFMpeg
  • Setup a systemd service

The following platforms are supported:

  • Ubuntu 18.04 & 16.04 (and derivatives, such as Linux Mint)
  • Debian 9
  • Fedora 28 & 27 (do not forget to check your SELinux configuration)
  • CentOS 7.4 (Python 3 must be installed)

Don’t like it?

sudo ./ uninstall

Note that PostgreSQL as well as the dependencies won’t be removed automatically (because I don’t want to screw your system). You might also want to remove FFMpeg at /usr/local/bin/ffmpeg.


After installing Docker, run the following command to download the latest KooZic image:

docker run -d -p 8069:8069 -p 8072:8072 -v <host_folder>:/mnt/host:ro --name koozic docmarty84/koozic

‘<host_folder>’ is the local folder containing your music.

KooZic should now be accessible in your browser at http://localhost:8069. To add your music in the library, simply create the folder ‘/mnt/host’ in the KooZic configuration.

The usual Docker instructions can be used to start and stop the container later on:

docker start koozic
docker stop koozic