Installing binaries#

HOOMD-blue binaries are available in the glotzerlab-software Docker/Singularity images and in packages on conda-forge

Singularity / Docker images#

See the glotzerlab-software documentation for instructions to install and use the containers on supported HPC clusters.

Conda package#

HOOMD-blue is available on conda-forge on the linux-64, osx-64, and osx-arm64 platforms. Install the hoomd package from the conda-forge channel into a conda environment:

$ conda install hoomd=4.0.1

conda auto-detects whether your system has a GPU and attempts to install the appropriate package. Override this and force the GPU enabled package installation with:

$ export CONDA_OVERRIDE_CUDA="11.2"
$ conda install "hoomd=4.0.1=*gpu*"

Similarly, you can force CPU only package installation with:

$ conda install "hoomd=4.0.1=*cpu*"


To use Run time compilation on macOS, install the compilers package:

$ conda install compilers

Without this package you will get file not found errors when HOOMD-blue performs the run time compilation.


Use mambaforge, miniforge or miniconda instead of the full Anaconda distribution to avoid package conflicts with conda-forge packages. When using miniconda, follow the instructions provided in the conda-forge documentation to configure the channel selection so that all packages are installed from the conda-forge channel.