Installation / Deployment and Configuration¶
Django-Music-Publisher can be installed/deployed as a stand-alone application, or used as a Python package.
Depending on your needs and technical knowledge, there are several options here. They are listed below, starting with the simplest option, which can be performed without any technical skills in under 5 minutes.
Deployment to Heroku (free tier)¶
Heroku is a cloud platform that lets companies build, deliver, monitor and scale apps — we’re the fastest way to go from idea to URL, bypassing all those infrastructure headaches.
Django-Music-Publisher can simply be deployed to a Free dyno (container) on Heroku with a free database with up to 10.000 rows. Depending on complexity of your metadata, this is enough for 500-1.000 musical works.
If you need more, plans costing between $9 and $16 per months will increase the limits to hundreds of thousands of works. If you ever need more, this will no longer be the right software anyway.
See https://www.heroku.com/pricing for details.
You will have to sign up with Heroku at https://signup.heroku.com/ and verify your e-mail, no payment information is required.
There are two ways to do it:
- Guided deployment, which uses a wizard that helps you fill out the deployment form, and
- Direct deployment, which does not, but takes you directly to the deployment form.
Guided Deployment to Heroku¶
The author and maintainer of Django-Music-Publisher runs a professional support service, providing automatic feature upgrades, security/bugfix updates, maintenance and user support.
It also provides a free (no registration required) pre-installation wizard that fills out the deployment form on Heroku. A society compatibility list is provided. If your society or society combination is not supported, use the next method.
Installing as Python package (developers only)¶
If you plan to use Django-Music-Publisher as one of the apps in your Django project, there is nothing special about it:
pip install --upgrade django_music_publisher
INSTALLED_APPS, no URLs need to be added, as everything goes
through the Django Admin.
PUBLISHER_SOCIETY_PR- Publisher’s performance collecting society (PRO) numeric code, required
PUBLISHER_SOCIETY_MR- Publisher’s mechanical collecting society (MRO) numeric code
PUBLISHER_SOCIETY_SR- Publisher’s synchronization collecting society numeric code, rarely used
For the list of codes, please refer to the official CISAC documentation.