MetaBrainz Foundation

Run a local BookBrainz server

This task should be quite easy to finish if you know how to open a command line interface/terminal. It involves visiting the BookBrainz source code repository on GitHub, checking out the latest stable code, installing dependencies and setting up a PostgreSQL database, and then starting the site and having a look at it in a browser.

First, head to the BookBrainz Github repository, click on the green "Clone or download" button and copy the URL that appears in the box. Scroll down the page a bit and you'll see the contents of the README file. Follow the instructions there to make a local copy of BookBrainz, install dependencies and set up the database.

When you've done this, you should be able to start the site by entering npm run debug in the terminal. Open up a browser window and head to http://localhost:9099 and you should see the BookBrainz homepage. Well done for getting this far - if you like, have a look around the site and learn a bit more about it.

When you're done, create a file with a history of the commands you ran in the terminal (type history, and copy the relevant commands into a file), along with details of the operating system you are using. In your browser, scroll to the bottom of the homepage and create a screenshot of the whole browser window. Then, write some comments on how you found the process, including whether anything was missing from the README, and post it on the task page, along with the command history and screenshot.

Task tags

  • first step
  • documentation
  • bookbrainz
  • nodejs

Students who completed this task

Yuukiro, Bruce R., C1e0, G30rg3, TheFaR8

Task type

  • chrome_reader_mode Documentation / Training
close

2018