MetaBrainz Foundation

Run a local BookBrainz server using Docker

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

First, follow the instructions in Running dependencies using Docker to install Docker and Docker Compose on your system.

Then, clone the BookBrainz GitHub repository as described by running git clone --recursive https://github.com/bookbrainz/bookbrainz-site.git, then follow the configuration and database set up instructions in the bookbrainz-site repository.

Once everything is set up and configured, proceed to the Running the server section: run ./develop.sh to start the docker containers. This will take some time as you build and download the images. Wait until the console output gets quiet and this line appears: > cross-env SSR=true node ./lib/server/app.js.

After a few seconds, you can then point your browser to http://localhost:9099 in your favorite web browser - when the site has loaded, scroll to the bottom of the homepage and create a screenshot of the whole browser window.

Post this as an attachment on the task page, then tell us what you thought about using Docker on the task page, what issues you ran into if any and how you fixed them.

Task tags

  • docker
  • bookbrainz
  • no code
  • cli

Students who completed this task

newbiecoder830, Jessie, Skye, abhi_ohri

Task type

  • chrome_reader_mode Documentation / Training

Level

Beginner
close

2018