Google Code-in

• Aim: run a local copy of the BookBrainz site that can be used for further exploration
• Time estimate: 1 hour

This task is intended for people who aren't confident in running commands in a terminal but are interested in contributing to some of the documentation and research tasks for BookBrainz. If you have some command-line experience, you might want to look at the more in-depth beginner task, "Run a local BookBrainz server".

Firstly, follow the instructions at https://docs.docker.com/ 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 type "docker run hello-world" (you may need to prefix with "sudo" on Mac/Linux systems). You should see the output of the basic introductory Docker application.

Once this is working, visit the BookBrainz Docker GitHub repository. Download and extract the ZIP file to a folder, then open a new terminal in this folder (Google how to do this, or ask in IRC). Finally, run the following 3 commands to get the BookBrainz site started:

docker-compose up -d postgresql
docker-compose run --rm site-dev /CreateDB.sh
docker-compose up site-dev

When you're done, the site will take between 30 and 60 seconds to to start. Try navigating to http://localhost:9099 in your favorite browser - when you successfully connect, create a screenshot of the bottom of the homepage, write some comments on how you found the process and post it on the task page.