spacer spacer

Handle.Net® Software

The Handle.Net software (HN_v9.3.1) together with the documentation included with the software, is available under the Handle.Net Public License Agreement (ver.2). Please read the license carefully before downloading the software.

Version 9.3.1 was released on February 2, 2023, with changes as outlined in the Release Notes.

Note: Handle.Net software has no dependency on log4j so is not vulnerable to "log4shell" (CVE-2021-44228).

Release Notes

The Release Notes describe the performance improvements and a variety of tool and configuration improvements made in the latest version of the software.

Upgrading to Version 9

We recommend that you upgrade to the latest version of the software.

Upgrading the software to Version 9 causes handle server storage changes which prevent downgrading to Handle.Net Version 8.1 or earlier. Full migration instructions are in the README.txt included with the distribution.

Send any questions and comments to the HNR Administrator at


Installation Notes

  • Handle servers should be installed by system administrators. It is very much like installing a Web server. The server should be installed on a machine with an Internet presence, which should be outside an organization's firewall. If it must be inside a firewall, then ports 2641 and 8000 need to be open to incoming and outgoing messages.
  • The download directory contains the software in Java™, and includes the Client Library — Java™ Version. The release includes an administrative client which enables identifier administration (creating, deleting, and modifying data); batch deposits, edits and deletions; creating prefixes and homing prefixes; and adding and deleting administrators and managing administrator permissions.
  • Version 9 will run on most platforms with Java 8 or higher.
  • Users are able to review the code and set up and configure the software, but will not be able to create or resolve handles until they agree to the Handle.Net Registry Service Agreement (HNRSA) and become a Local Handle Service provider. Instructions for how to register to become a Local Handle Service provider are included in the distribution.
  • Users who choose to become a Local Handle Service provider will be asked to send the file that was generated when the software was configured to the Handle.Net Registry Administrator. The file contains the information needed to create a prefix for the resolution service for which identifiers will be created.
  • Corporation for National Research Initiatives was allotted the credential "20" by the DONA Foundation. CNRI will issue prefixes derived from 20 to users of the HN_v9.3.1 software. The new prefixes will be of the form "20.500" followed by four or more digits, i.e. 20.500.1234. Prefixes issued under the older Handle System Service Agreement will remain in operation but that Agreement will no longer be available to new users of the software.
  • Download the Handle.Net logo.

February 2, 2022