Start/notes.ini Parameters/KeyFilename

KeyFilename

Parameter: KeyFilename
Short description: Full path to the Notes/Domino ID file. On the Notes client, KeyFilename points to the user ID; on the Domino server, it points to the server ID.

Profile

Parameter
KeyFilename
Category
Client configuration / Setup
Component
Notes client and Domino server
Value range
Absolute file path to a valid .id file
Default
Set automatically by setup (path to the user or server ID)
Available since
Very early (before 9.0.1) — standard setup parameter in all Notes/Domino versions
Effective
At program start
GUI equivalent
None directly — set during setup; on the client changeable via File → Security → User Security (Switch ID); on the server via the setup script or ID Vault recovery

Description

Full path to the Notes/Domino ID file.
  • On the Notes client, KeyFilename points to the user ID file (e.g. user.id).
  • On the Domino server, KeyFilename points to the server ID file (typically server.id).
The entry is written to notes.ini automatically during the first Notes/Domino setup and is required for startup. COM access from applications to Notes/Domino also uses the ID file specified in KeyFilename.

Examples

KeyFilename=C:\HCL\Notes\Data\user.id
KeyFilename=D:\Data\server.id
KeyFilename=/local/notesdata/server.id

Notes

  • The path must point to an existing, valid .id file. If the file is missing or the path is invalid, Notes/Domino startup fails.
  • During a server upgrade, it is important that KeyFilename continues to point to the correct server ID (HCL KB0039523 explicitly recommends verifying this after an upgrade).
  • Editing notes.ini directly is possible but risky. On Domino servers, maintenance via Configuration Settings documents or desktop policies is recommended.
  • Companion parameter on the server: ServerKeyFileName is also maintained (relative file name of the server ID).

Sources (HCL Product Documentation)