Skip to content

qHomeDirectory

Jump to bottom
Ecmel Ercan edited this page Sep 11, 2025 · 29 revisions

QHOME environment variable and kdb.qHomeDirectory setting are identical from the viewpoint of VS Code and they are used to locate the q executable for:

  • REPL
  • Bundled q connection

When QHOME is set through operating system, QHOME will always be used instead of kdb.qHomeDirectory for both use cases.

kdb.qHomeDirectory setting is in machine-overridable scope which means it can be set differently per remote machine or per workspace (.vscode/settings.json).

Settings for remote machine can be accessed with the following command after the remote connection is established:

image

If not set on a remote machine, user settings take precedence (It can be set to an empty string in remote settings to prevent overriding with user settings). For more information see VS Code documentation.

For REPL, a workspace .env file can also be used to set QHOME environment variable and if neither QHOME nor qHomeDirectory is set in any scope, path is searched for a KDB-X installation.

Clone this wiki locally