MusicBrainz Setup Guide - ajgillis04/GillisDockerDepot GitHub Wiki

MusicBrainz Setup Guide

Introduction

MusicBrainz is an open music encyclopedia that collects music metadata and makes it available to the public. It's a collaborative project that allows users to add, edit, and review music information.

Prerequisites

  • Docker installed
  • MusicBrainz container running in your Docker stack

Configuration Steps

Step 1: Accessing the MusicBrainz UI

  1. Open your browser and navigate to http://<your-ip-address>:5000.
  2. Log in with your MusicBrainz credentials.

Step 2: Initial Setup Wizard

  1. Follow the initial setup wizard to configure basic settings.
  2. Choose your preferred language for the MusicBrainz interface.
  3. Create an admin account by entering the admin username and password.
  4. Enter the database details (hostname, database name, database user, and password) to connect MusicBrainz to your database instance.
  5. Click Finish Setup.

Step 3: Configuring the Database

  1. Navigate to the Settings tab.
  2. Go to the Database section.
  3. Configure the database settings, including connection details and indexing preferences.
  4. Click Save.

Step 4: Adding Music Data

  1. Navigate to the Add tab.
  2. Select the type of music data you want to add (e.g., artist, release, recording).
  3. Fill in the required fields such as title, artist name, release date, and other relevant information.
  4. Click Save to add the music data to the database.

Step 5: Reviewing and Editing Music Data

  1. Navigate to the Review tab.
  2. Select the music data you want to review or edit.
  3. Make the necessary changes and save your edits.

Step 6: Customizing Settings

  1. Go to the Settings tab.
  2. Customize settings such as themes, notification preferences, and data validation rules.
  3. Click Save.

Notes

  • Ensure all paths and environment variables are updated in the musicbrainz.yaml file.
  • Regularly backup your config directory to save your settings and data.

Troubleshooting

  • Common Issues: List common issues and solutions.
  • Logs: Check MusicBrainz logs for error messages.
  • Support: Link to the MusicBrainz community and support resources.