Prebid Server - Java

The Java version of Prebid Server is for those who:
  • Want to host Programmatic Guaranteed
  • Or just prefer the Java language
Java Logo


We recommend you review the feature comparison list to familiarize yourself with the differences between this and PBS-Go in deciding which version is right for you.

Code Repositories


See Hosting your own Prebid Server for important architectural considerations, then follow the instructions for Installing PBS-Java.

Quick Start

There are a few test requests in sample/requests that work with prebid-config-file-bidders.yaml and the files in the samples/stored directory.

  1. Follow the instructions in the root-level README.txt file to build the server

  2. Start the server pointing to a config in the sample directory. e.g.

     java -jar target/prebid-server.jar --spring.config.additional-location=sample/prebid-config.yaml
  3. Use one of the stored requests in the sample directory with curl:

     cd sample
     curl --header "X-Forwarded-For:" -H 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36' -H 'Referer:' -H "Content-Type: application/json" http://localhost:8080/openrtb2/auction --data @FILENAME

    Where FILENAME is one of:

    • rubicon-storedresponse.json - this is a request that calls for a stored-auction-response.
    • appnexus-disabled-gdpr.json - this is a request that actually calls the appnexus endpoint after disabling GDPR by setting regs.ext.gdpr:0
    • pbs-stored-req-test-video.json - this is a stored-request/response chain returning a VAST document


See Also