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

  1. Start OWS once:

    sudo ows
    

    Without 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 id prints the same machine ID at any time.

  2. 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.

  3. Save the license file OSOP sends you as /opt/osop/license/ows.key. Keep the file name exactly ows.key.

  4. 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.