Using ndOffice Auto-Updating Features



  • OS: Windows
  • Browser: N/A
  • Office: N/A
  • Product: ndOffice


ndOffice notifies users about the release of a new version made available by NetDocuments.

IT/system administrators wishing to control their own update schedule and version choice using the built-in auto-update features can do so using the following settings. 

Please note this does not automatically download or update the client, it only makes the user aware that a new version is available through the following notification. Users must click on the notification to download and install the update. Local Administration rights are still required to update the application.

Standard view (no update available):  Updated version available:
standard update

How Auto-Update Works

Auto-update is ON by default for users who have not disabled the auto-update.

When auto-updates are enabled, ndOffice automatically contacts a NetDocuments service-specific URL every 30 minutes to check if there is an updated version available by comparing its version to the published version. The URL varies depending on the actual service you are using as configured in the ndOffice Settings Network tab and your chosen host. 

ndOffice checks for updates by looking at the manifest at:

Service Name Default URL for Auto-Update
 US (Vault)

So, for Vault this file reads as:

<ArrayOfInstallerPackageInfo xmlns="" xmlns:i="">

This file says that ndOffice is currently at version and that if the client is enabled for auto-update and it finds this manifest and the currently installed version is less than then, in that case, ndOfficeSetup.exe will be vended from the NetDocuments apps directory. 

Configuring an Alternative URL for Staging ndOffice

Should a NetDocuments customer want to control the timing of the update and the version of ndOffice, they would add these two registry value pairs: 

Value Pair Name String value (REG_SZ)

AlternativeUpdateUrlEnabled True

Registry key locations for the required keys are outlined below. Registry keys here are all strings (REG_SZ), and HKLM settings will override any HKCU value in the context of this article. 

Registry Locations for 32 and 64 bit OS (x64)


Setting Action Registry Key Value

Disable auto-updates

(ndOffice Settings > Account tab)

Controls whether the feature is enabled/disabled. AutoUpdateEnabled
  • True 
  • False

Prompt for automatic updates

(ndOffice Settings > Account tab)

Choose whether to show the 'New ndOffice version is available' in the ndOffice activity window (pictured above). PromptForAutomaticUpdates
  • True 
  • False

Alternative Update URL Enabled

(Not Available in user interface)

Choose whether to redirect the update check to your own specified appversions.xml file AlternativeUpdateURLEnabled
  • True 
  • False

Alternative Update URL

(Not Available in user interface)

The URL for the appversions.xml for your environment.  AlternativeUpdateURL

Custom e.g.


To use the alternative URL features you will need a webserver (e.g. IIS) configured with a matching hostname certificate for SSL/TLS with an "appversions.xml" file and directories to host your chosen installation version. Alternative ports can be chosen by specifying the port (e.g. but it must conform to HTTPS using a trusted certificate chain; to this end, self-signed certificates are not recommended. 

An example appversions.XML file content:

<ArrayOfInstallerPackageInfo xmlns="" xmlns:i="">
When making a new version available to users, the path should be updated with the new version of the executable and the version number updated to be higher than your existing installation to trigger the upgrade notification (e.g. your current installed version is and you want to upgrade to then you would update the web server with the XML above and place the updated executable alongside it or whichever local path is specified in the URL tags). If you are not using a local path to the web server, you should specify the full URL to the update file, e.g. <url></url>.

This will need to be made available externally across the internet should you wish to have users be able to update when out of the office, else they will receive an error when attempting an update check. 

It’s important that the alternative update URL references the manifest and that the manifest then points to the ndOffice vending location and instance.

Doing this, and editing the manifest, you can stage an auto-update from a location and time of your choosing to whichever version you want to update.

Refer to our Software Installation Guide for more information about ndOffice registry keys.

The following is an example registry file enabling AutoUpdate, with Prompt for Update on, Alternative URL on, and an example URL of specified. 

Back to Top

Was this article helpful?
0 out of 0 found this helpful
Powered by Zendesk