Detailed information for the notes.ini Keyword: 


Short Description: Allows Domino to include a specific IP address or hostname in its list of available DNS servers.



Does the 'DNSServer= ' parameter override the operating system DNS settings?

"DNSServer= " is a Lotus Domino® notes.ini file parameter that allows Domino to include a specific IP address or hostname in its list of available DNS servers. This parameter is useful when troubleshooting issues with the DNS server(s) required to resolve Internet host names.

Several issues have been reported regarding possible invalid behavior of the DNSServer parameter. The presumption was that this parameter would override the operating system settings when performing DNS lookup. Is this true?


NOTE: This parameter is valid in all environments but the usage as specified here is only relevant for the Microsoft® Windows™ operating system.

This feature is most useful when resolving non-public domains (internal domains). If the operating system settings point to trusted DNS servers for primary and alternates, the DNSServer parameter can be used to point to an internal DNS server.

The behavior of this parameter is designed to enhance the way the Microsoft network and operating system works. If a lookup fails, it will drop down to the operating system DNS settings. You cannot exclude the operating system DNS settings with this notes.ini parameter. This setting will allow additional DNS servers to be included in a DNS lookup. It just cannot exclude Netbios and operating system DNS settings.

Note from the 8.5.1 Fix Pack 4:

SPR# BSTS838NYV - DNS lookups no longer failover to the secondary DNS. With this fix, the "DNSServer=" Notes.ini variable will no longer be supported as we fully rely on the OS for DNS servers. For 8.5.1 FP4, if "DNSServer=" is enabled, the fix will be ignored.

Default value:

DNSServer=IP/DNS Name


UI equivalent:
There is no kown UI setting for this notes.ini variable. But you can specify this setting in the notes.ini settings tab of the configuration settings document.

Applies to:

Obsolete since version:

Entry created by:
Bastian W.