From 2effdb9b8720ba4253ac1b1b0c91254e5b4a64e4 Mon Sep 17 00:00:00 2001
From: Boyan Vladinov <boyan.vladinov@amd.com>
Date: Wed, 14 Jan 2026 15:18:09 +0200
Subject: [PATCH] license: Add commands for getting license key

Issue:
No license provided leads bf16 models running on *CPU*

Log:
<CACHE DIR>/vaiml_par_0/0/aiecompiler/aiecompiler-flexml.log
AIEMLbuild feature license not found !

Test:
export XILINXD_LICENSE_FILE=<ABSOLUTE PATH>/Xilinx.lic
run bf16 example

It should run on NPU

Signed-off-by: Boyan Vladinov <boyan.vladinov@amd.com>
---
 docs/linux.rst | 32 ++++++++++++++++++++++++++++++++
 1 file changed, 32 insertions(+)

diff --git a/docs/linux.rst b/docs/linux.rst
index 04a48d91..524b263a 100644
--- a/docs/linux.rst
+++ b/docs/linux.rst
@@ -123,6 +123,38 @@ Install Ryzen AI Software
    echo $RYZEN_AI_INSTALLATION_PATH
 
 
+**********************
+Getting License key
+**********************
+- Go to `AMD Product Licensing page <https://account.amd.com/en/forms/license/license-form.html>`_
+
+- Select **"2025 AI Engine Tools License"** and follow the on-screen instructions.
+
+
+- You will receive an email with the attached license file.
+
+- Export it as a system environment variable before starting the model compilation:
+
+.. code-block:: bash
+
+   export XILINXD_LICENSE_FILE=<ABSOLUTE PATH>/Xilinx.lic
+
+- In case you need to edit the licesne, go to `Manage Licenses page <https://amd.entitlenow.com/AcrossUser/main.gsp>`_
+
+.. note::
+
+      - License is locked to Host ID (MAC, etc).
+      - If you need running RyzenAI on separate host, then you must add its Host ID to the **"2025 AI Engine Tools License"**.
+      - **Troubleshooting**:
+
+.. code-block:: bash
+
+   In case of any issue please check log file in cache dir: aiecompiler-flexml.log
+
+   Check for message:
+   AIEMLbuild feature license not found !
+
+
 **********************
 Test the Installation
 **********************