Prebid Server is an open source implementation of Server-Side Header Bidding. It is managed by Prebid.org, and upholds the principles from the Prebid Code of Conduct.

This project does not support the same set of Bidders as Prebid.js, although there is overlap. The current set can be found in the adapters package. If you don't see the one you want, feel free to contribute it.

For more information, see:

• What is Prebid?
• Getting started with Prebid Server
• Current Bidders

When running, the server responds to several HTTP endpoints.

The server makes the following assumptions:

• No ranking or decisioning is performed by this server. It just proxies requests.
• No ad quality management (e.g., malware, viruses, deceptive creatives) is performed by this server.
• This server does no fraud scanning and does nothing to prevent bad traffic.
• This server does no logging.
• This server has not user profiling or user data collection capabilities.

This project is built upon Vert.x to achieve high request throughput. We use Maven and attempt to introduce minimal dependencies.

To start the Prebid Server you need to do the following steps:

• Build all-in-one JAR file from sources as described here.
• Create minimal needed configuration file prebid-config.yaml:

adapters:
  rubicon:
    enabled: true
    XAPI.Username: user1
    XAPI.Password: password1
metrics:
  prefix: prebid
cache:
  scheme: http
  host: localhost
  path: /cache
  query: uuid=%PBS_CACHE_UUID%
settings:
  filesystem:
    settings-filename: sample-app-settings.yml
    stored-requests-dir: /tmp
    stored-imps-dir: /tmp
gdpr:
  vendorlist:
    filesystem-cache-dir: /tmp
status-response: "ok"

Also, create the Data Cache settings file sample-app-settings.yml with content:

accounts:
  - 1001

For more information how to configure the server follow documentation.

• Run your server with the next command:

java -jar target/prebid-server.jar --spring.config.location=prebid-config.yaml

For more information how to start the server follow documentation.

• To verify everything is OK go to http://localhost:8080/status and check response status is 200 OK.