Skip to content

Latest commit

 

History

History
158 lines (115 loc) · 4.79 KB

INSTALL.md

File metadata and controls

158 lines (115 loc) · 4.79 KB

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 libseccomp-dev \
  pkg-config squashfs-tools cryptsetup

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 cryptsetup

NOTE: 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.12.6 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

Install golangci-lint

This is an optional (but highly recommended!) step. To ensure consistency and to catch certain kinds of issues early, we provide a configuration file for golangci-lint. Every pull request must pass the checks specified there, and these will be run automatically before attempting to merge the code. If you are modifying Singularity and contributing your changes to the repository, it's faster to run these checks locally before uploading your pull request.

In order to install golangci-lint, you can run:

$ curl -sfL https://install.goreleaser.com/github.com/golangci/golangci-lint.sh |
  sh -s -- -b $(go env GOPATH)/bin v1.15.0

This will download and install golangci-lint from its Github releases page (using version v1.15.0 at the moment).

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.3.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 attempt 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

Make sure you have also installed the system dependencies as shown above. Then download the latest release tarball and use it to install the RPM like this:

$ export VERSION=3.3.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.