> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domino.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use the Domino CLI behind a proxy

To configure the Domino CLI to use your proxy, you must modify files in the client installation directory:

* On Mac, the directory is: `/Applications/domino`

* On Windows, the directory is: `C:\Users\<your_username>\AppData\Local\Programs\domino`

In the root of the installation directory, there is a file named `domino.vmoptions` with some configuration options available. Add the line `-include-options ~/.domino/domino.vmoptions` at the *end* of the file for any \*nix based system (Windows users MUST specify the appropriate path where `domino.vmoptions` will be created):

```shell theme={null}
-Ddomino.defaultHost=
-Dhttp.proxyHost=
-Dhttp.proxyPort=
-Dhttp.nonProxyHosts=
-Dhttps.proxyHost=
-Dhttps.proxyPort=
-Dhttps.nonProxyHosts=
-include-options ~/.domino/domino.vmoptions
```

You must create the user level configuration file `domino.vmoptions` in the appropriate location/folder. The folder `~/.domino/` may not exist, in which case you should run `mkdir ~/.domino` to create it. You must have a user level configuration file to ensure your settings are never modified if the CLI is reinstalled or updated. In the new `~/.domino/domino.vmoptions`, assign your proxy’s port and host configuration:

```shell theme={null}
-Dhttp.proxyHost=YOURPROXYHOST
-Dhttp.proxyPort=1234
-Dhttps.proxyHost=YOURPROXYHOST
-Dhttps.proxyPort=1234
```

Replace `YOURPROXYHOST` and `1234` with your actual proxy connection information.

<Warning>
  Do not include `http(s)://` in the proxyHost parameters.
</Warning>

## Proxy authentication with the Domino CLI

CLI supports Basic and NTLM proxy authentication. Add the following parameters to your `~/.domino/domino.vmoptions` file for proxy authentication:

**Basic**

```shell theme={null}
# Make sure you have disabled the system proxy via this setting
-Djava.net.useSystemProxies=false
# This is required to enable basic authentication for Java versions >= Java 8u111
# More info here -> http://www.oracle.com/technetwork/java/javase/8u111-relnotes-3124969.html
-Djdk.http.auth.tunneling.disabledSchemes=
# (https) Do not include quotes
-Dhttps.proxyUser=YOURPROXYUSER
# (https) Do not include quotes, even if your password contains spaces
-Dhttps.proxyPassword=YOURPROXYPASSWORD
# (http) Do not include quotes
-Dhttp.proxyUser=YOURPROXYUSER
# (http) Do not include quotes, even if your password contains spaces
-Dhttp.proxyPassword=YOURPROXYPASSWORD
# Make sure to leave a blank line at the end
```

**NTLM**

```shell theme={null}
# This is an extension of Basic Proxy settings
# (http) Make sure to specify the NTLM domain for this Proxy
-Dhttp.auth.ntlm.domain=YOURNTLMDOMAIN
# (https) Make sure to specify the NTLM domain for this Proxy.
-Dhttps.auth.ntlm.domain=YOURNTLMDOMAIN
# Make sure to leave a blank line at the end
```

<Note>
  The proxy username is case-sensitive when using NTLM proxy authentication.
</Note>