Domain Expiry

The Domain Expiry check looks up when a domain's registration expires and warns you in time to renew it. It retrieves the expiry date over RDAP, the successor to WHOIS. The check runs on the device with the octoja agent on Windows, Linux, and macOS (each in x64 and Arm64 builds), every 12 hours by default.

Prerequisites

The device needs outbound HTTPS access to rdap.org and to the registry's RDAP service that rdap.org redirects to. See Configure firewall access for the agent for the required rules.

Steps

1. Open the device.
2. Choose Checks → Add Check → Domain Expiry.
3. Enter the registered domains under Domains and adjust the thresholds if needed.

Because the expiry date does not depend on the device, one assignment to a device with internet access is usually enough. To cover several devices, assign the check with a config package.

Settings

Thresholds

• Enter the registered domain, not a hostname below it: example.com rather than www.example.com. Before the lookup, the check converts the domain to lowercase and removes a trailing dot.
• If Warning (days before expiry) is lower than Error (days before expiry), the check swaps the two values before evaluation.
• Domains are looked up one after another. Timeout (ms) applies to each domain on its own.
• Blank entries are ignored, and leading and trailing spaces are removed.

Results

Every domain is graded on its own. The check reports the worst result across all domains.

The check calculates the remaining days from the exact expiry time, including fractions of a day. A value exactly on a threshold already triggers that level.

Not every registry publishes an expiry date over RDAP. The check reports such domains as Warning instead of showing them as OK.

Per domain, the check reports:

• The registration expiry date
• The days left until expiry
• The result and, where one applies, the reason

See also: Set up alerts for a check