Getting Started

Open Ad Server is an open source ad serving platform available as a managed service in Eyevinn Open Source Cloud. It provides campaign management, ad targeting, impression tracking, and delivery APIs for web and video advertising workflows.

Prerequisites

Step 1: Create a PostgreSQL instance

Navigate to PostgreSQL and create an instance. Note the internal TCP URL, username, and password from the instance card.

Build a full connection URL:

postgres://username:password@host:5432/postgres

Store this as a service secret named openads-dburl:

osc create-secret openads-dburl "postgres://username:password@host:5432/postgres"

Step 2: Create a Valkey instance

Navigate to Valkey and create an instance. Note the internal TCP URL.

Step 3: Create an Open Ad Server instance

Navigate to Open Ad Server → Create openadserver and fill in:

Field Required Description
name Yes Instance name (alphanumeric).
DatabaseUrl Yes Full PostgreSQL connection URL. Reference a service secret: {{secrets.openads-dburl}}.
RedisUrl Yes Internal URL of your Valkey instance (e.g. redis://host:6379).

Click Create. The service will run database migrations on first start. Once the status turns green, open the instance URL to access the ad server dashboard.

CLI usage

# Create dependencies first
osc create birme-osc-postgresql myadsdb \
  -o DbName="ads" \
  -o DbUser="adsuser" \
  -o DbPassword="{{secrets.ads-dbpass}}"

osc create valkey-io-valkey myadsvalkey

# Then create the ad server
osc create seanzhang414-openadserver myopenadserver \
  -o DatabaseUrl="{{secrets.openads-dburl}}" \
  -o RedisUrl="<valkey-internal-url>"

Resources