Installing and renewing the license
Save2ERP requires a license file signed by Swiss Computing, license.lic.
Installing the license
- Put
license.licat the root of the application (or at the location set byLICENSE_FILEin.env). With Docker, next todocker-compose.yml. - Restart the server.
- Check the logs: the
Licence : …line shows the installed license (customer, number of users, end date), or the reason why it is refused.
Without a valid license (missing, modified or expired), the pane shows an error page when it opens. The /test page remains available, so that the installation can be diagnosed.
Expiry
The license is valid until the end of its expiry day. During the 30 days before:
- the server reports it in the logs at each startup;
- the pane shows users a red banner "Your license expires in n days: contact support".
After the expiry date, no upload is possible any more: ask Swiss Computing for the renewal in time.
Renewing the license
Replace license.lic with the new file, then restart the server (with Docker: docker compose restart). No other step is needed, and the user register is kept.
License limited by number of users
With a limited license, each user is counted:
- when the pane opens, Word provides the user's Microsoft identity, usually without any action from the user;
- the server checks this identity with Microsoft and checks that the user belongs to the Microsoft 365 organization covered by the license;
- a user already counted always keeps their place;
- a new user is only accepted if a place is left;
- a user inactive for 30 days frees their place.
The check takes place at most once a day per user. It requires:
- admin consent to the Save2ERP application in Microsoft Entra ID (see Deploying in Microsoft 365);
- a version of Word that supports nested app authentication (see Requirements);
- access from the server to
login.microsoftonline.com.
Counted users are recorded in the user register (data/license-users.json, or the file set by LICENSE_USERS_FILE). It only contains a hash of each user, with the dates of first and last use: no name, no e-mail address. Keep it during updates: without it, counting starts again from zero.
An unlimited license counts nobody: the Microsoft identity is not requested and the register is not used.
License messages
| Message in the pane | Cause | What to do |
|---|---|---|
| License missing | No license file found. | Check the location of the file and LICENSE_FILE. |
| Invalid license | File modified, unreadable or not issued by Swiss Computing. | Put back the original file; details in the logs. |
| License expired | End date passed. | Install the new license. |
| Maximum number of users reached | All places are taken by active users. | Wait for a place to be freed (30 days of inactivity) or order additional users. |
| Organization not covered | The user does not belong to the license's Microsoft 365 organization. | Check the account the user is signed in to Word with. |
| Identity verification failed or Identity rejected | Microsoft identity not obtained or not verifiable. | See Troubleshooting. |