To configure the Domino CLI to use your proxy, you must modify files in the client installation directory:
On Mac, the directory is:
On Windows, the directory is:
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):
-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
in the appropriate location/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:
-Dhttp.proxyHost=YOURPROXYHOST -Dhttp.proxyPort=1234 -Dhttps.proxyHost=YOURPROXYHOST -Dhttps.proxyPort=1234
1234 with your actual proxy connection information.
CLI supports Basic and NTLM proxy authentication.
Add the following parameters to your
~/.domino/domino.vmoptions file for proxy authentication:
# 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
# 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