Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Cover Art Archive URL redirect service

This service will redirect from URLs to URLs, taking into account MBID redirects caused by release merges.

For example, this URL:

should redirect to:

Development setup

There are two ways of setting up the server: with and without Docker. First option might be easier if you are just getting started. Second requires having a MusicBrainz database set up on your machine.

Option 1: Docker-based

Make sure that you have Docker and Compose installed. To start the development server and its dependencies run:

$ docker-compose -f docker/ up --build

After all Docker images start you should be able to access the web server at localhost:8080.

Note: Keep in mind that any changes that you make won't show up until the server container is recreated. To do that you can simply stop the server (Ctrl + C) and run the command above again.

Option 2: Manual

CAA redirect server works with Python 3, so make sure that you have it installed. Create a virtual environment, if necessary.

Install all required packages using pip:

$ pip install -r requirements.txt

Copy config.default.ini to config.ini and adjust configuration values. You'd want to set up a connection to the instance of PostgreSQL with a MusicBrainz database that you should already have running.

Finally, run the script to start the server.

All logging goes to stdout, including stacktraces, so its suitable for running inside of daemontools.


Currently some tests depend on an actual MusicBrainz database running in the background, so make sure to follow the setup process first. We use Pytest as a test runner. All tests can be run with the following command:

$ pytest

There are more ways to use Pytest (for example, to run only tests for a specific module). Check their documentation to see what kinds of additional options you have.

With Docker you can run all the tests like this:

$ docker-compose -f docker/docker-compose.test.yml up --build

You should see test results in the output.