AxonServer Professional Cluster – License Questions

Hi,

I am upgrading from a standalone AxonServer setup to a 3-node cluster with a Professional subscription. The standalone setup has been running fine on Kubernetes for more than four years. I successfully set up the 3-node cluster, connected it to AxonIQ Console, and applications can connect without issues.

I am, however, confused about the AxonServer license:

  • With a Professional subscription being fully self-service, I expect to get everything I need via Console.
  • Is a license file still required for a cluster that is connected to Console?
  • The reference documentation mentions the license file, but I cannot find where to obtain it for the Professional subscription.
  • The setup instructions in Console say to configure the license directory as
    axoniq.axonserver.enterprise.licenseDirectory=/axonserver/license,
    but in the running instance this directory does not exist and is not automatically created.

Could someone clarify how the licensing works in this case?

Thanks,
Klaus

Hi,
I’m not sure if you already discovered the dedicated documentation page

The license is provided by Console and saved locally on your node. You can read more about how Console handles communication with AxonServer here

If you find something unclear in the documents, please let us know so we can improve them.

Hi,
thanks for your answer. To be honest I did not find the mentioned docs page. The docs are so fragmented that it is hard to navigate around.
Technically I understand the license rotation idea as descibed in License Rotation. But I do not see anything about a license in my setup. Not in Console and not in the AxonServer UIs.
The health indicator in AS shows license in warning state:


And on the left side it does not show a license:

Also, there is no license file create in the location I configured in axonserver.properties. (I configured “axoniq.axonserver.enterprise.licenseDirectory=/axonserver/security” because this is an existing directory that should be writable for the process)

Right now I simply don’t know if I have a license or not.

Klaus

Hi, maybe you missed my link in the previous reply
https://docs.axoniq.io/axon-server-installation/professional/kubernetes/

This is the specific installation guide for running Axonserver Professional in Kubernetes.

Please check all the steps and look if you, by chance, missed something: ensure that PVC location where you save your license file must be writable: in the example, it is configured at axoniq.axonserver.enterprise.licenseDirectory=/axonserver/data/license

Hi,

For whatever reason, the license has finally synced to my servers and was also stored as a file there. This definitely didn’t work before - maybe something in Console changed yesterday. Anyway, I now have the license.

That said, the license handling between Console and the AxonServer cluster is still quite confusing. In AxonServer, the license shows an expiration date with “x days left.” As a user and customer, this is irritating: I just purchased a Professional subscription, and now I’m told the license expires in 6 days. That’s a real “WTF” moment. I understand that the license will be automatically renewed, but this is mentioned nowhere.

The documentation also seems inconsistent. The docs linked from AxonIQ Console (https://console.axoniq.io/workspace/xxx/env/xxx/server/install/kubernetes) differ slightly from what’s written at https://docs.axoniq.io/axon-server-installation/professional/kubernetes. Moreover, there’s no link from Console to the main professional installation docs, and I couldn’t find a link from the AxonServer Reference Guide (https://docs.axoniq.io/axon-server-reference/v2025.1/) to the installation documentation. Overall, it feels a bit confusing and inconsistent.

Thanks,

Klaus

Thanks for your feedback,
we will improve it in the future.

Glad to know that your cluster is up and healthy.