Spack config.yaml

Spack package manager config.yaml file

Type object
File match **/*spack/**/config.yaml
Schema URL https://catalog.lintel.tools/schemas/schemastore/spack-config-yaml/latest.json
Source https://raw.githubusercontent.com/spack/schemas/refs/heads/main/schemas/config.json

Validate with Lintel

npx @lintel/lintel check
Type: object

Properties

config object

Spack's basic configuration options

Default:
{}
36 nested properties
flags object

Build flag configuration options

1 nested properties
keep_werror string

Whether to keep -Werror flags active in package builds

Values: "all" "specific" "none"
shared_linking string | object

Control how shared libraries are located at runtime on Linux

install_tree object

Installation tree configuration

3 nested properties
root string

The location where Spack will install packages and their dependencies

padded_length integer | boolean

Length to pad installation paths to allow better relocation of binaries (true for max length, integer for specific length)

projections Record<string, string>

Customize directory structure and naming schemes by mapping specs to format strings.

1 nested properties
all string

Default projection format string used as fallback for all specs that do not match other entries. Uses spec format syntax like "{name}/{version}/{hash:16}".

install_hash_length integer

Length of hash used in installation directory names

min=1
build_stage string | string[]

Temporary locations Spack can try to use for builds

stage_name string

Name format for build stage directories

develop_stage_link string

Name for development spec build stage directories

test_stage string

Directory in which to run tests and store test results

extensions string[]

List of Spack extensions to load

template_dirs string[]

Locations where templates should be found

license_dir string

Directory where licenses should be located

source_cache string

Location to cache downloaded tarballs and repositories

misc_cache string

Temporary directory to store long-lived cache files, such as indices of packages

environments_root string

Directory where Spack managed environments are created and stored

connect_timeout integer

Abort downloads after this many seconds if no data is received (0 disables timeout)

min=0
verify_ssl boolean

When true, Spack will verify certificates of remote hosts when making SSL connections

ssl_certs string

Path to custom certificates for SSL verification

suppress_gpg_warnings boolean

Suppress GPG warnings from binary package verification

debug boolean

Enable debug mode for additional logging

checksum boolean

When true, Spack verifies downloaded source code using checksums

deprecated boolean

If true, Spack will fetch deprecated versions without warning

locks boolean

When true, concurrent instances of Spack will use locks to avoid conflicts (strongly recommended)

dirty boolean

When true, builds will NOT clean potentially harmful variables from the environment

build_language string

The language the build environment will use (C for English, empty string for user's environment)

build_jobs integer

The maximum number of jobs to use for the build system (e.g. make -j), defaults to 16

min=1
concurrent_packages integer

The maximum number of concurrent package builds a single Spack instance will run

min=1
ccache boolean

When true, Spack's compiler wrapper will use ccache when compiling C and C++

db_lock_timeout integer

How long to wait to lock the Spack installation database

min=1
package_lock_timeout integer | null

How long to wait when attempting to modify a package (null for never timeout)

allow_sgid boolean

Allow installation on filesystems that don't allow setgid bit manipulation

install_status boolean

Whether to show status information in the terminal title during the build

url_fetch_method enum | string

The default URL fetch method to use (urllib or curl)

additional_external_search_paths string[]

Additional paths to search for external packages

binary_index_ttl integer

Number of seconds a buildcache's index.json is cached locally before probing for updates

min=0
aliases Record<string, string>

A mapping of aliases that can be used to define new Spack commands

installer string

Which installer to use. The new installer is experimental.

Values: "old" "new"