MetaBrainz Foundation

Setup a local AcousticBrainz development environment

This task is meant for people who are newbies to working with Python codebases, but are still interested in working on AcousticBrainz or other MetaBrainz Python development tasks.

First, follow the instructions at https://www.docker.com/community-edition and https://docs.docker.com/compose/install/ to install Docker and Docker Compose on your system. Once this is done, open the command-line interface for your system and enter "docker run hello-world" (you may need to add "sudo" on to the start of the command on Mac/Linux systems). You should see the some text output from the basic introductory Docker application.

After that, clone the AcousticBrainz codebase to your computer using git clone https://github.com/metabrainz/acousticbrainz-server. You'll probably need to install git on your computer for this. Linode has a very nice tutorial on how to install git that you can follow.

After that, follow the steps listed on the AcousticBrainz README.md. Once all the steps are done, the AcousticBrainz server should be accessible in your web browser on http://0.0.0.0:8080.

To complete the task, take a screenshot of your browser with the local AcousticBrainz instance open. Also, write a paragraph on what problems you faced during the setup process.

For any doubts, you can also reach out to us on #metabrainz, our IRC channel. We are a helpful lot, just mention you are from GCI and post your question. Wait for a while, someone will answer your query. Good luck!

Task tags

  • docker
  • setup
  • acousticbrainz

Students who completed this task

Bruce R., Jaykin

Task type

  • chrome_reader_mode Documentation / Training

Level

Beginner
close

2018