License, multiple domains, one CMS instance

I’m using Kirby as headless solution only and wondered, how the licensing model applies here.

So, I have a Kirby installation which I pull content from via kql/rest api. The website that consumes the content is translated into 3 languages, and those 3 languages are server by the same server, but I have domain redirections. Means, instead of having languages served under the /de, /fr and /en paths, they have separate domains (but it’s the same website).

Does that now mean because I’m using domains instead of subdomains/language paths, I have to get 3 licences, even though there is only one Kirby installation? Do you consider 1 licence key per one entity that belongs together or really per domain?

And the answer is “yes”, how will I register with the 3 licences?

Bonus question: I have multiple environments under those domains. Every domain has also a testing/staging environment. Will the licensing server understand that these are not separate websites but test instances?

No, language variations of the same website do not need their own licenses even if they run under different domains-

A “Website” is a single Kirby project that is defined by its domain name and root directory (e.g. or ). Each (sub)domain and root directory is a separate Website, even if the projects are related in any way. If the same Kirby multi-language installation spans multiple domains, these domains count as the same Website.

You can only register one domain, but I think if you put the license file into the config folder, it should get reflected on staging/testing. Not 100% sure.

The explanation by @pixelijn is correct. You will only need one license for all language versions and testing sites.

However you will need to register your license for each domain as Kirby will only consider the license valid if the domain matches. Make sure to use different config dirs, otherwise the license files will overwrite each other.

The license for one domain will automatically count for the staging and test subdomains though.

Alternative: Only use one of the domains for Panel access, then you only need to register the license for that domain. The Kirby core itself won‘t check the license.

1 Like

Thanks, both of you. Marked @lukasbestle answer as it references all information to the previous answer and adds clarification on top.