Skip to Content
PortcullisDocs
Operators (customer IT)

Network requirements

Firewall and storage requirements for running a Digicom product licensed by Portcullis.

Online installations

DirectionDestinationProtocol / portNeeded for
OutboundThe Portcullis API host (<portcullis-api-host>)HTTPS, TCP 443Activation, daily check-ins, deactivation
Inboundโ€”โ€”Nothing. Portcullis never connects to your server.
  • Allow outbound HTTPS to the Portcullis API host only. No other Digicom host is needed for licensing.
  • All requests go to paths under https://<portcullis-api-host>/api/v1/client/.
  • Traffic is small: one request at activation and typically one check-in per day per installation.
  • The product may let you override the Portcullis address with the PORTCULLIS_URL environment variable. Only change it if Digicom asks you to.

Rate limits

Portcullis limits requests per source IP address: by default 60 requests per minute, and an IP address that makes 10 failed requests within 5 minutes (for example wrong license keys) is blocked for 15 minutes. Normal use stays far below these limits, but remember that all installations behind one NAT address share them.

Air-gapped installations

No network access is needed. Use Offline activation.

What happens during an outage

The product keeps running on its current license file if it cannot reach Portcullis, whether the cause is your firewall, your internet connection or Digicom's server. It retries quietly in the background.

  • A license file is valid for its lease (typically 30 days) after the last successful check-in.
  • After that, a grace period (typically 14 days) starts. The product keeps working but shows administrators a warning with the days left.
  • Only after lease and grace (typically 44 days) does the product switch to restricted mode. Restricted mode never deletes your data.

The exact lease and grace values depend on your license.

Storage

WhatRequirement
Product data directoryPersistent storage (disk, Docker volume or Kubernetes persistent volume). It holds the installation ID, the license file and a small state file.
PORTCULLIS_INSTALLATION_IDOptional environment variable that pins the installation's identity in containers. Keep it stable and unique per installation.

System clock

Keep the server's clock correct (for example with NTP). Setting the clock back can put the product into a restricted clock_tampered state.

On this page