Start/notes.ini Parameters/KeepManagementURL

KeepManagementURL

🛠️
Parameter: KeepManagementURL
Summary: URL of the DRAPI management port – must be switched to https when DRAPI runs over HTTPS, otherwise the restapi task fails to start.

Profile

Parameter
KeepManagementURL
Category
General
Component
Server
Available since
12.0
Supported versions
12.0, 14.0, 14.5, 14.5.1
GUI equivalent
notes.ini only (no GUI)
Possible values
Full URL, default http://localhost:8889

Description

KeepManagementURL defines the URL on which the Domino REST API (DRAPI) exposes its management endpoint. Routes such as /config, /info, and shutdown/restart commands are reachable through this endpoint. The management port has its own functional account and is intentionally separated from the HTTP, HTTPS, and Prometheus ports.

Example configuration

KeepManagementURL=https://localhost:8889

Notes & pitfalls

  • When DRAPI is switched to HTTPS, KeepManagementURL must be changed to https://... as well – otherwise the restapi task aborts at startup.
  • The management port (default 8889) should be reachable only from localhost. Block it on the firewall or bind it to 127.0.0.1.
  • Takes effect on start or reload of the restapi task.
  • Together with KeepInstallDir and KeepLogConfigFile, this forms the DRAPI baseline configuration in the notes.ini.