Merge pull request #601 from EESSI/EESSI-env-variables

Add EESSI-env-variables to docs

Author: trz42

docs/using_eessi/setting_up_environment.md

@@ -206,6 +206,36 @@ $ module av
 # ...
 ```
 
+??? tip "Environment variables to consider while initializing EESSI"
+
+    ### OVERRIDING variables
+
+    | Environment variables | Description |
+    |-----------------------|------------------------|
+    | `EESSI_CVMFS_REPO_OVERRIDE` | Overrides the default CVMFS repository path (e.g. /cvmfs/software.eessi.io) used by init. |
+    | `EESSI_VERSION_OVERRIDE` | Overrides the default EESSI version subdirectory (e.g. 2023.06) selected by init. |
+    | `EESSI_SOFTWARE_SUBDIR_OVERRIDE` | Overrides detected CPU software subdir (e.g. linux/x86_64/intel/icelake) for the main stack. |
+    | `EESSI_ACCELERATOR_TARGET_OVERRIDE` | Overrides detected accelerator target (e.g. accel/nvidia/cc70) regardless of local hardware. |
+    | `EESSI_ARCHDETECT_OPTIONS_OVERRIDE` | Replaces any built-in archdetect options with the provided value. |
+
+    ### Source-based Initialization
+
+    | Environment variable | Description |
+    |-----------------------|------------------------|
+    | `EESSI_BASIC_ENV` | When set to 1, performs a minimal init only exporting essential  variables. |
+    | `EESSI_SILENT` | When set to 1, suppresses non-error output during source-based init; errors still print. |
+    | `EESSI_USE_ARCHDETECT` | When set to 0, disables automatic architecture detection using archdetect; otherwise detection is performed. |
+
+    ### Module-based Initialization
+
+    | Environment variable | Description |
+    |-----------------------|------------------------|
+    | `EESSI_DEBUG_INIT` | When set to 1, enables verbose debug output from init scripts to trace decisions and paths. |
+    | `LMOD_SYSTEM_DEFAULT_MODULES` | List of modules Lmod auto-loads on shell start; can include EESSI/2023.06 to auto-enable. |
+    | `EESSI_MODULE_FAMILY_NAME` | Name of the family applied to the EESSI module (default EESSI); affects family conflicts. |
+    | `EESSI_MODULE_STICKY` | When set to 1, enables sticky behavior of the EESSI module. |
+
+
 ??? tip "The accelerator modules are visible but I can't load them"
 
     Do note that just because the accelerator modules are now visible doesn't mean you will be able to load them. EESSI