Skip to content

Latest commit

 

History

History
136 lines (98 loc) · 4.04 KB

INSTALL.md

File metadata and controls

136 lines (98 loc) · 4.04 KB
Raw

Installing Singularity

Since you are reading this from the Singularity source code, it will be assumed that you are building/compiling.

For full instructions on installation, check out our installation guide.

Install system dependencies

You must first install development tools and libraries to your host. On Debian-based systems:

$ sudo apt-get update && \
  sudo apt-get install -y build-essential \
  libssl-dev uuid-dev libgpgme11-dev libseccomp-dev pkg-config squashfs-tools

On CentOS/RHEL:

$ sudo yum groupinstall -y 'Development Tools' && \
  sudo yum install -y epel-release && \
  sudo yum install -y golang openssl-devel libuuid-devel libseccomp-devel squashfs-tools

On CentOS/RHEL 6 or less, you may skip libseccomp-devel.

Install Golang

This is one of several ways to install and configure golang. The CentOS/RHEL instructions above already installed it so this method is not needed there.

First, download the Golang archive to /tmp/, then extract the archive to /usr/local.

$ export VERSION=1.11.4 OS=linux ARCH=amd64  # change this as you need

$ wget -O /tmp/go${VERSION}.${OS}-${ARCH}.tar.gz https://dl.google.com/go/go${VERSION}.${OS}-${ARCH}.tar.gz && \
  sudo tar -C /usr/local -xzf /tmp/go${VERSION}.${OS}-${ARCH}.tar.gz

Finally, set up your environment for Go:

$ echo 'export GOPATH=${HOME}/go' >> ~/.bashrc && \
  echo 'export PATH=/usr/local/go/bin:${PATH}:${GOPATH}/bin' >> ~/.bashrc && \
  source ~/.bashrc

Clone the repo

Golang is a bit finicky about where things are placed. Here is the correct way to build Singularity from source:

$ mkdir -p ${GOPATH}/src/github.com/sylabs && \
  cd ${GOPATH}/src/github.com/sylabs && \
  git clone https://github.com/sylabs/singularity.git && \
  cd singularity

To build a stable version of Singularity, check out a release tag before compiling:

$ git checkout v3.1.0

Compiling Singularity

You can build Singularity using the following commands:

$ cd ${GOPATH}/src/github.com/sylabs/singularity && \
  ./mconfig && \
  cd ./builddir && \
  make && \
  sudo make install

And that's it! Now you can check your Singularity version by running:

$ singularity version

To build in a different folder and to set the install prefix to a different path:

$ ./mconfig -p /usr/local -b ./buildtree

Install from the RPM

NOTE: You should only atempt to build the RPM on a CentOS/RHEL system.

To build the RPM, you first need to install rpm-build and wget:

$ sudo yum -y update && sudo yum install -y rpm-build wget

Then download the latest release tarball and use it to install the RPM. Since we are building from the RPM, you don't need to install Golang, but you do need to install the other dependencies.

$ export VERSION=3.1.0  # this is the singularity version, change as you need

$ wget https://github.com/sylabs/singularity/releases/download/v${VERSION}/singularity-${VERSION}.tar.gz && \
    rpmbuild -tb singularity-${VERSION}.tar.gz && \
    sudo rpm -ivh ~/rpmbuild/RPMS/x86_64/singularity-${VERSION}-1.el7.x86_64.rpm && \
    rm -rf ~/rpmbuild singularity-${VERSION}*.tar.gz

Alternatively, to build an RPM from the latest master you can clone the repo as detailed above. Then create your own tarball and use it to install Singularity:

$ cd $GOPATH/src/github.com/sylabs/singularity && \
  ./mconfig && \
  make -C builddir rpm && \
  sudo rpm -ivh ~/rpmbuild/RPMS/x86_64/singularity-3.0.3-687.gf3da9de.el7.x86_64.rpm # or whatever version you built

To build an rpm with an alternative install prefix set RPMPREFIX on the make step, for example:

$ make -C builddir rpm RPMPREFIX=/usr/local

For more information on installing/updating/uninstalling the RPM, check out our admin docs.