Skip to content

Update configuration scopes in the configuration tutorial #601

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
nmnobre wants to merge 1 commit into
base: main
Choose a base branch
from
Open

Update configuration scopes in the configuration tutorial #601

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 5 additions & 4 deletions tutorial_configuration.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -89,22 +89,23 @@ Configuration Scopes
--------------------

Depending on your use case, you may want to provide configuration settings common to everyone on your team, or you may want to set default behaviors specific to a single user account.
Spack provides seven configuration *scopes* to handle this customization.
These scopes, in order of decreasing priority, are:
Spack provides several configuration *scopes* to handle this customization.
These scopes, in order of decreasing priority, include:

============ ===================================================
Scope Directory
============ ===================================================
Command Line N/A
Environment In environment base directory (in ``spack.yaml``)
Custom Custom directory, specified with ``--config-scope``
Spack ``$SPACK_ROOT/etc/spack/``
User ``~/.spack/``
Site ``$SPACK_ROOT/etc/spack/``
Site ``$SPACK_ROOT/etc/spack/site``
System ``/etc/spack/``
Defaults ``$SPACK_ROOT/etc/spack/defaults/``
============ ===================================================

Spack's default configuration settings reside in ``$SPACK_ROOT/etc/spack/defaults``.
Spack's default configuration settings reside in ``$SPACK_ROOT/etc/spack/defaults``, including platform-specific and base subdirectories/subscopes.
These are useful for reference, but should never be directly edited.
To override these settings, create new configuration files in any of the higher-priority configuration scopes.

Expand Down
Loading