Skip to Content
PortcullisDocs
Operators (customer IT)

Online activation

Activate a Digicom product on a server that can reach the internet.

Use this when the server running the Digicom product can make outbound HTTPS connections. If it can't, use Offline activation.

Before you start

  • You have the license key from Digicom. It looks like OMF-7KQ2M-HX9TB-P4WRN-3ZC8D. Treat it like a password.
  • The server can reach the Portcullis API host over outbound HTTPS. See Network requirements.
  • The product's data directory is on persistent storage. It holds the installation's identity and its license file. In Docker or Kubernetes, use a persistent volume, and optionally set PORTCULLIS_INSTALLATION_ID (see below).

Steps

  1. Install and start the product as described in its install guide.
  2. Open the product's license or setup screen.
  3. Enter the license key. Lowercase, spaces and missing dashes are fine.
  4. Confirm. The product contacts Portcullis, receives a signed license file and stores it.
  5. Check that the product shows the expected customer name, expiry date and limits, for example "Licensed to Acme Logistics until 2027-11-14, 500 vehicles".

That's it. From now on the product checks in automatically (typically once a day) to refresh its license and pick up renewals or changes from Digicom. You don't need to do anything when your contract is renewed.

Containers: PORTCULLIS_INSTALLATION_ID

Each installation has an installation ID, stored in the data directory. If the data directory is lost, the product looks like a new installation and uses another of your license's installation slots.

In Docker or Kubernetes you can pin the ID with an environment variable. Set it to a fixed value (a UUID is a good choice) that is unique to this installation:

environment:
  PORTCULLIS_INSTALLATION_ID: "3f0b6a0e-6a52-4c1e-9a55-1d2f8f0c7b11"
  • Keep the value the same across restarts and upgrades.
  • Don't reuse the value for a different installation. Two installations with the same ID look to Digicom like a copied installation.

If something goes wrong

The product shows an error message. Look it up in Troubleshooting. The most common ones:

Message / codeWhat to do
LICENSE_NOT_FOUNDCheck the key for typos and that it's for this product.
MACHINE_LIMIT_REACHEDAll installation slots are in use. Deactivate an old installation, or contact Digicom.
Network errorCheck outbound HTTPS to the Portcullis API host.

On this page