﻿# Licence

> WorkSmartHub needs a licence file from WorkWise Solutions. The licence is stored in the application database, so it survives restarts and upgrades, and every server of a multi-node installation uses the same licence.

Source: https://workwise-solutions.net/docs/features/licence/ · Language: en · Hungarian version: https://workwise-solutions.net/hu/docs/features/licence/

WorkSmartHub needs a licence file from WorkWise Solutions. The licence is stored in the application database, so it survives restarts and upgrades, and every server of a multi-node installation uses the same licence.

Menu: **Alkalmazás → Licenc**. The menu item has a warning badge when the licence is not valid.

![Licence page](https://workwise-solutions.net/docs/images/app-licence.png)
*A valid licence with its customer name, dates and licensed features.*

## What the page shows

- The status: *Licenc érvényes* (valid), *Licenc hamarosan lejár* (expiring soon, the renewal warning period has started), *Licenc lejárt* (expired), *Licenc sérült* (corrupted), or *Az alkalmazás nem licencelt* (no licence).
- **Licenc**: the customer name; **Kezdő dátum** (start), **Lejárati dátum** (expiry), **Lejárati figyelmeztetés dátuma** (renewal warning date), in UTC.
- **Engedélyezett funkciók** (Licensed features), for example:
  - `workTicketManagement`: work tickets (the **Munkajegyek** menu and the ticket API);
  - `mobileApplication`: the mobile app activation ([Mobile app](https://workwise-solutions.net/docs/features/mobile-app/)).

Without a valid licence, the application redirects every page to the licence page.

## Uploading a licence

Click **Új licenc fájl feltöltése** (Upload new licence file) and choose the file. Who may upload:

- **While there is no valid licence** (none, expired or corrupted): anyone, signed in or not. A new installation can therefore be licensed before its first user exists, and an expired installation can be renewed even though nobody can work in it.
- **Replacing a valid licence** (including one in its renewal warning period): only a **Super admin**. Others get a *not authorised* error.

A file that is not a valid licence is refused (*A megadott licenc lejárt* expired, *A megadott licenc sérült* corrupted).

## Through the API

The licence file is sent as the raw request body (`application/octet-stream`), not as a multipart form upload:

```bash
# no valid licence yet: no sign-in needed
curl -X POST https://wsh.example.com/api/licensing/set \
  -H "Content-Type: application/octet-stream" --data-binary @license.key

# status (no sign-in needed)
curl https://wsh.example.com/api/licensing/status
```

Replacing a valid licence through the API needs a Super Admin's access token as `Authorization: Bearer <access token>` ([API usage](https://workwise-solutions.net/docs/api-usage/)).

## Visibility

The **Licenc** menu item is shown to users with any permission besides *Public*; users with only *Public* see it when **App Konfiguráció → Oldal Láthatóságok → Licenc** is enabled.
