License¶
OWS runs on the computer it is licensed for. The license is a small text file, ows.key, made by OSOP for that
computer’s machine ID. OWS checks it every time it starts; it doesn’t need an internet connection to do so.
Get a license¶
Start OWS once:
sudo owsWithout a license, OWS doesn’t start. It prints the reason and this computer’s machine ID:
❌ ows license: no license file found. Send this machine ID to OSOP to obtain a license: OSOP3-YMEQ-SC2H-MV9F-T87B-2J9X Save the license file you receive as /opt/osop/license/ows.key
sudo ows idprints the same machine ID at any time.Send the machine ID to OSOP. Copy and paste it rather than retyping it; the last character is a check character, so a typing mistake is caught.
Save the license file OSOP sends you as
/opt/osop/license/ows.key. Keep the file name exactlyows.key.Check it, then start OWS:
sudo ows check sudo ows
sudo ows check says whether the license is valid for this computer and shows its details, including the
expiry date (valid-until) and the days left. If the license isn’t valid, it gives the reason; see
License messages.
The machine ID¶
The machine ID (OSOP3- followed by five groups of four characters) comes from the unique ID of the computer’s
motherboard. It stays the same when you reinstall Linux, Docker or OWS. It changes when:
OWS moves to a different computer or a different motherboard;
OWS runs in a new virtual machine (a new VM gets a new hardware ID).
In those cases, start OWS on the new computer and send its machine ID to OSOP for a new license.
Some computers and virtual machines have no unique hardware ID. OWS then can’t show a machine ID and says so; contact OSOP. WSL 2 on Windows and Docker Desktop are in this group: use a Linux computer or a Linux virtual machine instead (Installation).
When the license expires¶
OWS checks the license when it starts. In the days before the expiry date, it may start with a warning in its
output (sudo ows logs):
⚠️ ows license for <your organization> expires in 12 days (2027-06-30). Contact OSOP to renew.
A running OWS keeps running past the expiry date, but the next start (sudo ows restart, a reboot) fails with
the license has expired. Contact OSOP to renew, then
replace /opt/osop/license/ows.key with the new file and run sudo ows restart.
Licenses from older OWS versions¶
Licenses made for OWS versions released before November 2026 don’t work with the current version, and machine IDs
look different (they now start with OSOP3-). After upgrading, start OWS with sudo ows and send the new
machine ID to OSOP.