Skip to main content

Environment variables

Omni supports a number of environment variables for its configuration. Setting those will generally override equivalent configuration options or precede them.

VariableTypeDescription
OMNIPATHcolon-delimited list of pathsProvides the paths to different omni commands. See parameters/path for more details.
OMNI_CONFIGfilepathThe path to an omni global configuration file. See files.
OMNI_FORCE_UPDATEstringForce-triggers omnipath and self updates when set to anything but an empty string, even if it should have triggered. It is recommended to either set to 1 or empty/unset. Is superseded by OMNI_SKIP_UPDATE and OMNI_SKIP_SELF_UPDATE.
OMNI_GITpathThe worktree where omni will clone and look for repositories. Overrides the configuration. See parameters/worktree for more details.
OMNI_NONINTERACTIVEstringDisables interactive prompts when set to anything but an empty string. It is recommended to either set to 1 or empty/unset.
OMNI_ORGcomma-delimited list of stringsPrepend organizations to be considered by omni. e.g.: OMNI_ORG="git@github.com:XaF,github.com/XaF". See parameters/org for more details.
OMNI_SKIP_SELF_UPDATEstringDisables self updates when set to anything but an empty string, even if it should have triggered. It is recommended to either set to 1 or empty/unset.
OMNI_SKIP_UPDATEstringDisables omnipath and self updates when set to anything but an empty string, even if it should have triggered. It is recommended to either set to 1 or empty/unset.