Using the Domino CLI Behind a Proxy

You can configure the Domino CLI to use your proxy with the following changes. You’ll need to 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 will need to specify the appropriate path where domino.vmoptions will be created):

-Ddomino.defaultHost=
-Dhttp.proxyHost=
-Dhttp.proxyPort=
-Dhttp.nonProxyHosts=
-Dhttps.proxyHost=
-Dhttps.proxyPort=
-Dhttps.nonProxyHosts=
-include-options ~/.domino/domino.vmoptions

You will need to 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. A user level configuration file is necessary to ensure your settings are never modified in the scenario that the CLI is reinstalled or updated. In the newly created ~/.domino/domino.vmoptions, assign your proxy’s port and host configuration:

-Dhttp.proxyHost=YOURPROXYHOST
-Dhttp.proxyPort=1234
-Dhttps.proxyHost=YOURPROXYHOST
-Dhttps.proxyPort=1234

You’ll need to replace YOURPROXYHOST and 1234 with your actual proxy connection information.

Proxy Authentication with the Domino CLI

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

Basic

# 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

# 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.