(c) 2018-2020 Óscar García Amor
Redistribution, modifications and pull requests are welcomed under the terms of GPLv3 license.
Polaris is a music streaming application, designed to let you enjoy your music collection from any computer or mobile device.
This docker packages Polaris under Alpine Linux, a lightweight Linux distribution.
Visit Docker Hub or Quay to see all available tags.
To run this container, simply exec.
docker run -t -d \
--name=polaris \
-p 5050:5050 \
ogarcia/polaris
This start polaris
and publish the port to host. You can go to
http://localhost:5050 to see it running.
Warning: this is a basic run, all data will be destroyed after container stop and rm.
This container exports two volumes.
- /music: for store you music collection
- /var/lib/polaris: polaris data like database and logs (under
.local/share/polaris
)
You can exec the following to mount your music dir and store data.
docker run -t -d \
--name=polaris \
-p 5050:5050 \
-v /my/music/directory:/music \
-v /my/polaris/data:/var/lib/polaris \
ogarcia/polaris
Take note that you must create before the data directory /my/polaris/data
and set ownership to UID/GID 100, otherwise the main proccess will crash.
mkdir -p /my/polaris/data
chown -R 100:100 /my/polaris/data
The run-polaris
command can use the following environment variables.
Variable | Used for | Default value |
---|---|---|
POLARIS_PORT | Define listen port | 5050 |
POLARIS_CONFIG | Optional config file location | |
POLARIS_DB | Optional database file location | |
POLARIS_LOGLEVEL | Optional log level between 0 (off) and 3 (debug) |
If you can run a shell instead run-polaris
command, simply do.
docker run -t -i --rm \
--name=polaris \
-p 5050:5050 \
-v /my/music/directory:/music \
-v /my/polaris/data:/var/lib/polaris \
--entrypoint=/bin/sh \
ogarcia/polaris
Please note that the --rm
modifier destroy the docker after shell exit.