Mac OS X


  1. Download and install Miniconda using the following instructions

  2. Open Terminal to execute the following commands.

  1. Add the conda-forge channel

    conda config --add channels conda-forge

    The conda-forge channel provides multitude of community maintained packages. Find out more about it here

  2. Create a virtual environment in conda

    conda create --name cubeenv python=3.6 datacube
  3. Activate the virtual environment

    source activate cubeenv

    Find out more about managing virtual environments here

  4. Install other packages

    conda install jupyter matplotlib scipy

    Find out more about managing packages here

Datacube is now installed and can be used in Terminal by activating the cubeenv environment.

Manual Installation (Fallback)

Only follow these steps if the Miniconda installation does not suit your needs.


This section was typed up from memory. Verification and input would be appreciated.

See also Mac and Homebrew install instructions.

Required software


/usr/bin/ruby -e "$(curl -fsSL"

HDF5, netCDF4, and GDAL:

brew install hdf5 netcdf gdal

Python and packages

Python 3.5+ is required (3.6 is recommended)

Download the latest version of the software from the repository and install it:

git clone
cd datacube-core
git checkout develop
python install

It may be useful to use conda to install binary packages:

conda install psycopg2 gdal libgdal hdf5 rasterio netcdf4 libnetcdf pandas


Usage of virtual environments is recommended