Go to file
Eliot Berriot 16365ded56 Merge branch '87-radio-delete' into 'develop'
Fixed #87:Now always load next radio track on last queue track ended

Closes #87

See merge request funkwhale/funkwhale!65
2018-02-27 18:41:26 +00:00
api Fixed #88: Now exclude tracks without file from radio candidates 2018-02-27 19:20:55 +01:00
changes Merge branch '88-exclude-empty-radio' into 'develop' 2018-02-27 18:39:25 +00:00
demo
deploy
docker/nginx
docs Fixed #85: broken documentation 2018-02-27 13:18:49 +01:00
front Merge branch '87-radio-delete' into 'develop' 2018-02-27 18:41:26 +00:00
.dockerignore
.editorconfig
.env.dev
.gitattributes
.gitignore
.gitlab-ci.yml
CHANGELOG Now use towncrier for changelog management 2018-02-27 19:04:50 +01:00
CONTRIBUTORS.txt
LICENSE
README.rst
dev.yml
pyproject.toml Now use towncrier for changelog management 2018-02-27 19:04:50 +01:00

README.rst

Funkwhale
=============

A self-hosted tribute to Grooveshark.com.

LICENSE: BSD

Setting up a development environment (docker)
----------------------------------------------

First of all, pull the repository.

Then, pull and build all the containers::

    docker-compose -f dev.yml build
    docker-compose -f dev.yml pull


API setup
^^^^^^^^^^

You'll have apply database migrations::

    docker-compose -f dev.yml run celeryworker python manage.py migrate

And to create an admin user::

    docker-compose -f dev.yml run celeryworker python manage.py createsuperuser


Launch all services
^^^^^^^^^^^^^^^^^^^

Then you can run everything with::

    docker-compose up

The API server will be accessible at http://localhost:6001, and the front-end at http://localhost:8080.

Running API tests
------------------

Everything is managed using docker and docker-compose, just run::

    ./api/runtests

This bash script invoke `python manage.py test` in a docker container under the hood, so you can use
traditional django test arguments and options, such as::

    ./api/runtests funkwhale_api.music   # run a specific app test