Skip to content

Installing and renewing the license ​

Save2ERP requires a license file signed by Swiss Computing, license.lic.

Installing the license ​

  1. Put license.lic at the root of the application (or at the location set by LICENSE_FILE in .env). With Docker, next to docker-compose.yml.
  2. Restart the server.
  3. 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 paneCauseWhat to do
License missingNo license file found.Check the location of the file and LICENSE_FILE.
Invalid licenseFile modified, unreadable or not issued by Swiss Computing.Put back the original file; details in the logs.
License expiredEnd date passed.Install the new license.
Maximum number of users reachedAll places are taken by active users.Wait for a place to be freed (30 days of inactivity) or order additional users.
Organization not coveredThe 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 rejectedMicrosoft identity not obtained or not verifiable.See Troubleshooting.