Introduction

Spack is a flexible package manager designed for scientific software. It supports multiple compiler versions, dependency resolution, build variants, and installation into isolated environments. This guide provides step-by-step instructions on how to search for, inspect, and install libraries and tools using Spack.

From source with Spack

Visit the Spack Project

Spack contains packages for all of the products listed in the E4S 26.11 Full Release category. General instructions for building software with Spack can be found at the Spack website. Questions concerning building those packages are deferred to the associated package development team.

Some quickstart instructions are below.


1. Set Up Spack

1.1 Clone Spack Core

git clone https://github.com/spack/spack.git
cd spack
git checkout 8d1b485913f4eb227042f7c47d2f04421ece7308
cd ..

1.2 Clone the E4S 26.11 branch of Spack Packages

git clone -b e4s-26.11 https://github.com/spack/spack-packages.git

1.3 Add Spack to your shell

. spack/share/spack/setup-env.sh

1.4 Set builtin Spack repo destination

spack repo set --destination $(pwd)/spack-packages builtin

To isolate this Spack instance from user- and system- level configuration directories, set SPACK_DISABLE_LOCAL_CONFIG=1.

To load Spack automatically on startup, add . share/spack/setup-env.sh to your shell profile (e.g., ~/.bashrc, ~/.zshrc).


2. Finding Libraries and Tools

spack list <name_of_package>

Example:

spack list tau

2.2 List all available packages

spack list

2.3 List all packages in E4S

spack list --tag e4s

3. Inspecting Package Details

3.1 Show detailed information

spack info <package>

This displays:

  • Description
  • Available versions
  • Variants (options)
  • Dependencies
  • Licenses

Example:

spack info hdf5

3.2 View available versions

spack versions <package>

4. Installing Packages

4.1 Basic installation

spack install <package>

4.2 Install a specific version

spack install <package>@<version>

Example:

spack install fftw@3.3.10

5. Customizing Builds with Variants

Most scientific software has optional features. Use + to enable and ~ to disable features.

Example: Enable MPI and threading in HDF5

spack install hdf5 +mpi +threadsafe

Example: Disable shared libraries

spack install trilinos ~shared

6. Selecting Compilers

6.1 List available compilers

spack compilers

6.2 Add a new compiler

spack compiler find

6.3 Install with a specific compiler

spack install kokkos %gcc@13.3.1

6.4 Install with variants and compiler

spack install petsc +mpi +debug %gcc@11.4.0

7. Managing Dependencies

Spack resolves dependencies automatically. To view the dependency tree:

spack spec <package>

Example:

spack spec kokkos +cuda cuda_arch=90

8. Using Installed Packages

8.1 View installed packages

spack find
spack find -d   # include dependencies

8.2 Load a package into your environment

spack load <package>

8.3 Unload a package

spack unload <package>

Spack environments let you manage sets of packages together.

9.1 Create an environment

spack env create myenv
spack env activate myenv

9.2 Add and install packages

spack add trilinos +mpi
spack add kokkos +cuda +wrapper cuda_arch=90
spack install

Note that some packages, like Kokkos, default to cuda_arch=None (check with spack info kokkos). This variable must be specified according to the CUDA compute capability with which the package is being built.

9.3 View environment packages

spack find

9.4 Deactivate environment

spack env deactivate

10. Using Binary Caches (Faster Installs)

To see available prebuilt binaries:

spack buildcache list

Spack will use binaries automatically if available.


11. Troubleshooting

Issue Solution
Build failed spack -d install <pkg> for debug output
Wrong compiler used Specify %compiler explicitly
Dependency mismatch Check with spack spec <pkg>
Clean build spack clean --all

12. Advanced Tips

  • Search by tags:
    spack list --tag <tag>
    
  • Find reverse dependencies:
    spack dependents <package>
    
  • Get help:
    spack help
    spack help install
    

13. Summary Workflow

# Find a package
spack list <name>

# Inspect it
spack info <name>

# Customize & verify
spack spec <name +options %compiler@version>

# Install
spack install <name +options %compiler@version>

# Load for use
spack load <name>

15. Additional Resources

  • Official documentation: https://spack.readthedocs.io
  • Package index: https://packages.spack.io
  • Tutorials: https://spack.io/tutorials
  • GitHub: https://github.com/spack/spack

Conclusion

Spack makes it easy to discover, configure, and install complex scientific software stacks. By understanding how to search for packages, inspect build options, control compilers and dependencies, and manage environments, you can consistently build powerful and reproducible software configurations.