minio/BUILDDEPS.md

Ubuntu (Kylin) 14.04

Build Dependencies

This installation document assumes Ubuntu 14.04 or later on x86-64 platform.

Install Git, GCC and MkDocs

$ sudo apt-get install git build-essential python-pip
$ sudo pip install mkdocs

Install YASM

Minio depends on Intel ISAL library for erasure coding, ISAL uses Intel AVX2 processor instructions, to compile these files one needs to install yasm which supports AVX2 instructions. AVX2 support only ended in yasm from version 1.2.0, any version below 1.2.0 will throw a build error.

$ sudo apt-get install yasm

Install Go 1.4+

Download Go 1.4+ from https://golang.org/dl/ and extract it into ${HOME}/local and setup ${HOME}/mygo as your project workspace folder. For example:

.... Extract and install golang ....

$ wget https://storage.googleapis.com/golang/go1.4.linux-amd64.tar.gz
$ mkdir -p ${HOME}/local
$ mkdir -p $HOME/mygo
$ tar -C ${HOME}/local -xzf go1.4.linux-amd64.tar.gz

.... Export necessary environment variables ....

$ export PATH=$PATH:${HOME}/local/go/bin
$ export GOROOT=${HOME}/local/go
$ export GOPATH=$HOME/mygo
$ export PATH=$PATH:$GOPATH/bin

.... Add paths to your bashrc ....

$ cat << EOF > ${HOME}/.bashrc
export PATH=$PATH:${HOME}/local/go/bin
export GOROOT=${HOME}/local/go
export GOPATH=$HOME/mygo
export PATH=$PATH:$GOPATH/bin
EOF

Mac OSX (Yosemite) 10.10

Build Dependencies

This installation document assumes Mac OSX Yosemite 10.10 or later on x86-64 platform.

Install brew

$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

Install Git, Python and MkDocs

$ brew install git python
$ pip install mkdocs

Install YASM

Minio depends on Intel ISAL library for erasure coding, ISAL uses Intel AVX2 processor instructions, to compile these files one needs to install yasm which supports AVX2 instructions. AVX2 support only ended in yasm from version 1.2.0, any version below 1.2.0 will throw a build error.

$ brew install yasm

Install Go 1.4+

On MacOSX brew.sh is the best way to install golang

For example:

.... Install golang using `brew` ....

$ brew install go
$ mkdir -p $HOME/mygo

.... Export necessary environment variables ....

$ export GOPATH=$HOME/mygo
$ export PATH=$PATH:$GOPATH/bin
$ GOVERSION=$(brew list go | head -n 1 | cut -d '/' -f 6)
$ export GOROOT=$(brew --prefix)/Cellar/go/$GOVERSION/libexec

.... Add paths to your bashrc ....

$ cat << EOF > ~/.bashrc
GOVERSION=$(brew list go | head -n 1 | cut -d '/' -f 6)
export GOPATH=$HOME/mygo
export PATH=$PATH:$GOPATH/bin
export GOROOT=$(brew --prefix)/Cellar/go/$GOVERSION/libexec
EOF