Installation

Installation of Mineserver is generally trouble-free, but this page should offer a little more detail for those who desire it. Right now only source distributions are available; this will change once there is a stable release.

Binary Packages

This will be written up when there are binary releases available.

Source Distributions

Prerequisites

Mineserver requires 3 external libraries: zlib, libevent and libnoise. The method of obtaining these libraries may differ system to system, so consult your operating system's manual.

General

Installation is generally very simple and consists of just a few steps.

1. Obtain source
2. Install prerequisites
3. Build Mineserver
4. Edit config

Obtaining the Source Code

The source code for Mineserver is available from GitHub and in future as tarballs for stable revisions.

Checking out the source from git is straightforward: simply clone the repository from GitHub and it's ready to be compiled. An explanation of how to use git is outside the scope of this article, but there are plentiful resources on the topic to be found with your favourite search engine.

Installing prerequisites

Windows

(needs to be filled in)

Debian and Similar

To build software on Debian, the build-essential package is required. This package will provide you with the basic gcc/g++ toolchain. The prerequisites for Mineserver can be found in the packages zlib1g-dev, libevent-dev and libnoise-dev.

CentOS/RHEL

CentOS, and RHEL do not provide support for libnoise natively. As such we will need to manually compile and install the library.

 wget http://prdownloads.sourceforge.net/libnoise/libnoisesrc-1.0.0.zip?download -O libnoisesrc-1.0.0.zip
 unzip libnoisesrc-1.0.0.zip; cd noise
 less README # Read this 
 make
 cp -R include /usr/local/include/libnoise
 cp lib/* /usr/local/lib
 sudo echo "/usr/local/lib" > /etc/ld.so.conf/user.conf
 sudo /sbin/ldconfig

All other dependancies can be installed with the following commands:

 # Install EPEL (Extra Packages for Enterprise Linux) 
 sudo su -c 'rpm -Uvh http://download.fedora.redhat.com/pub/epel/5/i386/epel-release-5-4.noarch.rpm' 
 sudo yum install git libevent libevent-devel zlib zlib-devel

Building Mineserver

Windows

(needs to be filled in)

Debian and Similar

To build the mineserver binary, simply enter the src directory in the source distribution and run make. If you receive errors referring to missing files, check that you have all the prerequisites installed.

Editing the Config

This part is nice and easy. Grab the default config files from the bin directory in the distribution and view the configuration article to get accustomed with the options available.