Skip to main content

Ad-Flow Configuration Guide

This guide covers all available configuration options for the Ad-Flow container. For AWS, configuration is done by modifying the ECS CloudFormation templates.

Core Configuration Parameters​

Stream Settings​

ParameterDescriptionExampleNotes
INPUT_IPIP address for receiving video input"127.0.0.1"For RTP, use 127.0.0.1. For SRT, use source IP
INPUT_PORTPort number for video input"5004"Must match source stream port
OUTPUT_IPDestination IP for processed stream"10.0.1.15"For SRT, use "0.0.0.0"
OUTPUT_PORTPort number for output stream"5005"Must match receiver's input port
STREAM_PROTOCOLStreaming protocol selection"rtp" or "srt"Determines protocol for both input and output
DELAY_SECONDSBuffer duration for ad detection"120"Must exceed longest expected ad break

SCTE-35 Configuration​

ParameterDescriptionExampleNotes
SCTE35_FILLER_REPEAT_SECONDSInterval for repeating markers"5"Default: 5 seconds
SCTE35_TIME_AHEAD_SECONDSPre-roll time for markers"5"Time before ad break starts

Monitoring Settings​

ParameterDescriptionExampleNotes
METRICS_PUSH_GATEWAYPrometheus metrics endpoint"http://localhost:9091/metrics"For monitoring integration
CHANNEL_NAMEInstance identifier for metrics"channel1"Used in Prometheus/Grafana

SRT-Specific Configuration​

ParameterDescriptionExampleNotes
INPUT_SRT_STREAMIDStream identifier for input"stream1"Optional
INPUT_SRT_PASSPHRASEInput stream encryption key"secretkey"Optional
OUTPUT_SRT_STREAMIDStream identifier for output"stream1_out"Optional
OUTPUT_SRT_PASSPHRASEOutput stream encryption key"secretkey"Optional

Advanced Settings​

Scheduling​

ParameterDescriptionExampleNotes
SHUTDOWN_SCHEDULEAutomatic shutdown timing"02:30 1,2,3,4,5"Format: "HH:mm [days]" (UTC)

Debug Options​

ParameterDescriptionDefaultNotes
EXTRA_LOGEnhanced logging"0"Set to "1" to enable

About Input/Output port modification​

When modifying INPUT_PORT or OUTPUT_PORT, you must also modify the inbound rules in your Security Group. This is done for example in the CloudFormation templates.

For RTP, the security group must allow the INPUT_PORT as an inbound rule.

For SRT, the security group must allow the OUTPUT_PORT as an inbound rule.

Example Configuration​

Basic RTP Setup​

ParameterValue
INPUT_IP127.0.0.1
INPUT_PORT5004
OUTPUT_IP10.0.1.15 (IP of video encoder's RTP input)
OUTPUT_PORT5005 (port number of video encoder's RTP input)
STREAM_PROTOCOLrtp
DELAY_SECONDS120
METRICS_PUSH_GATEWAYhttp://localhost:9091/metrics
CHANNEL_NAMEchannel1

SRT with Security​

ParameterValue
INPUT_IP11.22.33.44 (IP of SRT source)
INPUT_PORT5004
OUTPUT_IP0.0.0.0
OUTPUT_PORT5005
STREAM_PROTOCOLsrt
DELAY_SECONDS120
INPUT_SRT_STREAMIDstream1
INPUT_SRT_PASSPHRASEsecretkey
OUTPUT_SRT_STREAMIDstream1_out
OUTPUT_SRT_PASSPHRASEsecretkey
METRICS_PUSH_GATEWAYhttp://localhost:9091/metrics
CHANNEL_NAMEchannel1_srt

Configuration Best Practices​

  1. Stream Delay

    • Set DELAY_SECONDS to accommodate your longest expected ad break
    • Consider adding a buffer of 15-30 seconds to the expected maximum

  2. Security

    • For RTP, use appropriate firewall rules
    • For SRT, always use passphrases in production
    • Restrict access using security groups

  3. Monitoring

    • Always set a unique CHANNEL_NAME
    • Enable EXTRA_LOG during initial setup
    • Monitor Grafana dashboards regularly

  4. Network Configuration

    • Use elastic IPs where possible
    • Configure appropriate network security groups
    • Test connectivity before deployment