Software licensing

With hostware, you can easily sell software products and add paid licensing to them. For that, enable the HwLicensing module in the module list.

Enable licensing feature

The licensing feature is hidden by default. To enable the feature, append the following string to your .env file in /var/www/hostware:

HOSTWARE_ENABLE_SOFTWARE_PRODUCTS=true

Reload the cache:

cd /var/www/hostware && php artisan optimize

After that, you can enable the licensing module.

Manage software packages

In the administration sidebar you can find the new "Software" menu entry. Here you can manage one or multiple software packages. Each package can have multiple versions with a proper changelog and download link.

Also, each version can contain an encrypted as well as an open source version.

Configure software product

During product creation, you can now select the "SOFTWARE" type. Select the "HwLicensing" module for the provisioning as usual.

At the tab "Software" you can then select the desired software package which should be available for this product.

API for validation

hostware offers a REST API endpoint to validate the validity of a given license.

Validate (JSON)

POST/api/v1/license/{licenseKey}/verify

Replace the licensekey in the URL.

Headers

Response

{
    "license": {
        "product_hosting_number": "VN-11605",
        "module_name": "HwLicensing",
        "status": "ACTIVE",
        "product_options": {
            "204": {
                "id": 204,
                "label": "250 Kunden-Accounts",
                "value": 250
            }
        },
        "created_at": "2026-05-06T20:14:49.000000Z"
    },
    "product": "keyhelp-whmcs-modul-leased",
    "product_data": {
        "id": 1133,
        "name": "Keyhelp WHMCS Modul",
        "description": "-"
    },
    "customer": "hostware GmbH",
    "company": "hostware GmbH",
    "full_name": "Max Mustermann",
    "email": "[email protected]",
    "service_data": {
        "renew_next": "2026-05-09T20:20:46.000000Z",
        "renew_last": "2026-05-06T20:20:46.000000Z",
        "period_name": "Monatlich",
        "period_price": 50,
        "monthly_price": 50
    }
}

{
    "error": "License not found"
}

{
    "error": "License is not active (installing)"
}

Validate (WHMCS Style)

Our customers can easily migrate from WHMCS to hostware. The local license verification code does not need to be adjusted, you just have to change the url. hostware will return the data 1:1 the same style as WHMCS so your integration does not break.

POST/api/v1/license/whmcs-verify

Body

Response

Successful

hostware will return the same structure used by the WHMCS verification endpoint. That way, existing integrations wont break.

<status>Active</status>
<registeredname>Max Mustermann</registeredname>
<companyname>hostware GmbH</companyname>
<email>[email protected]</email>
<serviceid>VN-11605</serviceid>
<productid>1133</productid>
<productname>Keyhelp WHMCS Modul</productname>
<regdate>2026-05-06T20:14:49.000000Z</regdate>
<nextduedate>2026-05-09T20:20:46.000000Z</nextduedate>
<billingcycle>Monatlich</billingcycle>
<validdomain>-</validdomain>
<validip>-</validip>
<validdirectory></validdirectory>
<configoptions>Amount of accounts=250</configoptions>
<customfields></customfields>
<addons></addons>
<md5hash></md5hash>