Type something to search...
Browse documentation

Run ProPR without internet access

Install and operate ProPR where the only things it can reach are your SCM host, your model endpoint, and your own infrastructure.

Nothing in ProPR calls home: no license server, no catalog download, and no service of ours in the path your code takes - see where your code goes. What follows is what you have to bring inside the boundary, what needs no network at all, and what still has to cross one.

What has to be inside the boundary

RequirementNotes
The three release images, mirroredPull them from the public registry into your internal one and keep the tags aligned - see running published images
Not a source buildBuilding the images from the checkout needs package feeds, so mirroring released images is the offline path - see quickstart
PostgreSQL with the vector extensionSee what you need
A writable review workspace volumeSee review workspace
A durable, backed-up key ring volumeSee what to back up

What needs no network at all

CapabilityWhy it works offline
The model catalogEmbedded in the product; a newer snapshot is an operator upload, not a fetch - see the model catalog
The ProRV knowledge lensIts catalog is embedded too - see review passes
The edition and its capabilitiesStored in your own database and set in the management UI; no license server is contacted in either edition - see setting the edition
Sign-inLocal accounts need nothing external. Single sign-on to a cloud identity provider does, and is licensed - see sign-in and sessions
Review diagnosticsThe protocol, findings and thread memory are all in your database - see reviews

Point ProPR at a model you host

Use the openAiCompatible family for anything serving an OpenAI-shaped API at a URL you supply, including something you run yourself - see AI providers.

On a private address it needs the private-egress opt-in, which relaxes less than its name suggests: read outbound request protection before you plan the endpoint. In practice it means a TLS certificate the container running ProPR trusts, because nothing skips certificate validation.

Three family-specific consequences of a private endpoint:

  • Azure OpenAI. A private endpoint keeps the Azure hostname this family requires - see outbound request protection.
  • AWS Bedrock. A private or VPC endpoint names no region, so supply it as the region default query parameter, and enter the models by hand because discovery needs an AWS host - see AWS Bedrock.
  • Embeddings. Thread memory and ProCursor need an embedding model, so something on your side of the boundary has to serve one. Check what degrades if nothing does - see purposes.

What still crosses a boundary

  • Your AI provider, unless you host the model yourself. This is the whole reason the compliance host list exists - see restrict where your code goes.
  • Your SCM host. The self-hosted variants authenticate with a credential issued by that host. Hosted Azure DevOps Services is the exception: it authenticates through Microsoft Entra, so it needs reachable Microsoft identity endpoints as well as the Azure DevOps host itself. See support matrix.
  • Your own collectors, if you configured a trace or log endpoint - see observability.

Confirm it worked

  1. Verify each AI connection. The probe is a real call to your endpoint, so a green verification proves the path, the credential and the certificate at once.
  2. Call GET /healthz and confirm every check it reports is healthy - see what the health checks mean.
  3. Attach a model from the catalog and confirm it arrives with a context window and a price. That metadata came from inside the image; nothing was fetched.
  4. Trigger one review from the API and read its protocol - see trigger a review.
  5. Read your egress logs for that review. Your SCM host and your model endpoint should be the only destinations.

If a verification or a health check fails, troubleshooting routes the symptom.