MusicBrainz Server/Setup: Difference between revisions

From MusicBrainz Wiki
Jump to navigationJump to search
m (Moved installation instructions to top.)
No edit summary
Line 7: Line 7:
# If you just want a running database (no website frontend) see the [[Database Setup|database setup]] guide instead.
# If you just want a running database (no website frontend) see the [[Database Setup|database setup]] guide instead.
# Additionally, if you want to setup your own search server instead of having to query <code>search.musicbrainz.org</code>, there is a [http://bugs.musicbrainz.org/browser/search_server/trunk/README README] for that.
# Additionally, if you want to setup your own search server instead of having to query <code>search.musicbrainz.org</code>, there is a [http://bugs.musicbrainz.org/browser/search_server/trunk/README README] for that.

An alternate option is to install a [[Virtual MusicBrainz Server|virtual MusicBrainz server]]. The virtual image comes fully configured with a Linux environment and the latest stable release of the <code>mb_server</code> source code.


The requirements may look daunting, but please don't let this discourage you; the INSTALL/README files are thorough and contain a lot of information, and we are willing to provide assistance. If you have questions about installing, join us in the [http://webchat.freenode.net/?channels=musicbrainz #musicbrainz IRC channel] or post a question on the [[Developers Mailing List|developers mailing list]] and we will attempt to help you out.
The requirements may look daunting, but please don't let this discourage you; the INSTALL/README files are thorough and contain a lot of information, and we are willing to provide assistance. If you have questions about installing, join us in the [http://webchat.freenode.net/?channels=musicbrainz #musicbrainz IRC channel] or post a question on the [[Developers Mailing List|developers mailing list]] and we will attempt to help you out.
Line 12: Line 14:
We recommend that you dive in and give it a try - who knows how far you'll get and what you might learn along the way!
We recommend that you dive in and give it a try - who knows how far you'll get and what you might learn along the way!


==Introduction==
==Requirements==


In order to set up a running MusicBrainz server on your machine you will need the following:
In order to set up a running MusicBrainz server with the full database you will need:
* A linux box, preferably Ubuntu, that is a PIII-700 or better, with 256MB RAM and 2Gb of free disk space.
* A linux box, preferably Ubuntu, that is a PIII-700 or better with 256MB RAM.
* 8GB of free disk space, (if you are a developer and only want the server code and database structure 2GB is more than enough).
* A knowledge of Apache, Perl, mod_perl, PostgreSQL and a number of perl modules.
* [[Subversion]] knowledge which will enable you to check out the source code.
* [[Subversion]] knowledge which will enable you to check out the source code.
* A knowledge of how to compile and install packages from source on a Linux box.
* A knowledge of how to patch existing packages is helpful, although we can help you out if you have questions about that.

Some additional notes to keep in mind:
* You do not actually need to know SQL/Perl to setup the server, but if you plan on adding features to MusicBrainz it will help to have experience in those areas.
* The server has ''never been ported to Windows'', and we suspect that it would be a fair amount of work to make that happen.


As a developer the following knowledge/skills are beneficial:
An alternative option to the above is to install a [[Virtual MusicBrainz Server|virtual MusicBrainz server]] that comes fully configured with a Linux environment and the latest release of the <code>mb_server</code> source code.
* Apache, Perl, mod_perl, PostgreSQL and a number of perl modules.
* How to compile and install packages from source on a Linux box.
* How to patch existing packages, although we can help you out if you have questions about that.


Note: The server has ''never been ported to Windows'', and we suspect that it would be a fair amount of work to make that happen.
If you are considering helping out with [[Development|server development]], thank you! Otherwise, happy hacking!


[[Category:WikiDocs Page]] [[Category:Development]] [[Category:Server]]
[[Category:WikiDocs Page]] [[Category:Development]] [[Category:Server]]

Revision as of 17:36, 14 January 2010

Products > Server > Server development > Server setup

Installation instructions

  1. If you are a MusicBrainz developer working on the next server release use /trunk/INSTALL.
  2. For everyone else use the latest stable release, /branches/RELEASE_20090524-BRANCH/INSTALL.
  3. If you just want a running database (no website frontend) see the database setup guide instead.
  4. Additionally, if you want to setup your own search server instead of having to query search.musicbrainz.org, there is a README for that.

An alternate option is to install a virtual MusicBrainz server. The virtual image comes fully configured with a Linux environment and the latest stable release of the mb_server source code.

The requirements may look daunting, but please don't let this discourage you; the INSTALL/README files are thorough and contain a lot of information, and we are willing to provide assistance. If you have questions about installing, join us in the #musicbrainz IRC channel or post a question on the developers mailing list and we will attempt to help you out.

We recommend that you dive in and give it a try - who knows how far you'll get and what you might learn along the way!

Requirements

In order to set up a running MusicBrainz server with the full database you will need:

  • A linux box, preferably Ubuntu, that is a PIII-700 or better with 256MB RAM.
  • 8GB of free disk space, (if you are a developer and only want the server code and database structure 2GB is more than enough).
  • Subversion knowledge which will enable you to check out the source code.

As a developer the following knowledge/skills are beneficial:

  • Apache, Perl, mod_perl, PostgreSQL and a number of perl modules.
  • How to compile and install packages from source on a Linux box.
  • How to patch existing packages, although we can help you out if you have questions about that.

Note: The server has never been ported to Windows, and we suspect that it would be a fair amount of work to make that happen.