Network requirements
Firewall and storage requirements for running a Digicom product licensed by Portcullis.
Online installations
| Direction | Destination | Protocol / port | Needed for |
|---|---|---|---|
| Outbound | The Portcullis API host (<portcullis-api-host>) | HTTPS, TCP 443 | Activation, 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_URLenvironment 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
| What | Requirement |
|---|---|
| Product data directory | Persistent storage (disk, Docker volume or Kubernetes persistent volume). It holds the installation ID, the license file and a small state file. |
PORTCULLIS_INSTALLATION_ID | Optional 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.