From 40ec154a97bbb15baa15fc571d332c6cbd086e3f Mon Sep 17 00:00:00 2001
From: Eugene Nesvetaev <dev@nesvet.dev>
Date: Sun, 28 Jun 2026 15:20:32 +0400
Subject: [PATCH] Document legacy AMI opt-in and ASUS EXTRNIP download_endpoint

---
 README.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/README.md b/README.md
index 9973f20..094e8ea 100644
--- a/README.md
+++ b/README.md
@@ -240,6 +240,16 @@ zplug install
 
 Clone this repository and source `nojava_ipmi_kvm_completion.plugin.zsh` in your `.zshrc`.
 
+## ASUS / AMI BMC without DNS hostname
+
+Some ASUS ASMB8 and similar BMCs return an invalid JNLP when the BMC has no DNS name. Use `EXTRNIP` in `download_endpoint`:
+
+```yaml
+download_endpoint: "Java/jviewer.jnlp?EXTRNIP=<bmc-ip>&JNLPSTR=JViewer"
+```
+
+Replace `<bmc-ip>` with the address clients use to reach the BMC.
+
 ## Acknowledgement
 
 -   Special thanks to @mheuwes for adding the new YAML config file format and adding HTML5 support!