AMS server configuration

Ant Media Server can be configured either through the management console (web panel) or by directly modifying the configuration files. Most settings are defined in the configuration files.

Main Configuration File

The primary configuration file is located at: <AMS_DIR>/conf/red5.properties. Below are the available server configuration options.

General Server Settings

• policy.host: Socket policy host. Default: 0.0.0.0
• policy.port: Socket policy port (must be open). Default: 843
• server.name: Ant Media Server name (optional).
• server.licence_key: Ant Media Server license key (required for Enterprise Edition).
• server.heartbeatEnabled: Enables server heartbeat. Default: true
• server.kafka_brokers: Kafka broker address (default Kafka port is 9092). Optional.
• server.cpu_limit: CPU usage limit (percentage). Default75
• server.min_free_ram: Minimum free RAM required (in MB). Default: 10
• logLevel: Logging level (TRACE, DEBUG, INFO, WARN, ERROR). Default:INFO
• useGlobalIp: Whether to use the global IP for WebSocket clusters. Default: false

HTTP Settings

• http.host: HTTP host. Default: 0.0.0.0
• http.port: HTTP port. Default: 5080
• https.port: HTTPS port. Default: 5443
• http.URIEncoding: URI encoding. Default: UTF-8
• http.max_keep_alive_requests: Maximum keep-alive requests. Default: -1
• http.max_threads: Maximum HTTP threads. Default: 20
• http.acceptor_thread_count: Acceptor thread count. Default: 10
• http.processor_cache: Processor cache size. Default: 20

RTMP Settings

• rtmp.host: RTMP host. Default: 0.0.0.0
• rtmp.port: RTMP port. Default: 1935
• rtmp.io_threads: IO thread count. Default 16
• rtmp.send_buffer_size: Send buffer size. Default: 65536
• rtmp.receive_buffer_size: Receive buffer size. Default: 65536
• rtmp.ping_interval: Ping interval (ms). Default: 1000
• rtmp.max_inactivity: Maximum inactivity (ms). Default: 60000
• rtmp.max_handshake_time: Max handshake time (ms). Default: 5000
• rtmp.tcp_nodelay: TCP no-delay option. Default: true
• rtmp.tcp_keepalive: TCP keep-alive option. Default: false
• rtmp.default_server_bandwidth: Default server bandwidth. Default: 10000000
• rtmp.default_client_bandwidth: Default client bandwidth. Default: 10000000
• rtmp.client_bandwidth_limit_type: Bandwidth limit type. Default: 2
• rtmp.bandwidth_detection: Bandwidth detection. Default: false
• rtmp.encoder_base_tolerance: Encoder base tolerance (ms). Default: 5000
• rtmp.encoder_drop_live_future: Drop live future frames. Default: false
• rtmp.traffic_class: Traffic class. Default: -1
• rtmp.backlog: Backlog size. Default: 32
• rtmp.thoughput_calc_interval: Throughput calculation interval. Default: 15
• rtmp.default_acceptor: Default acceptor. Default:. Default: true
• rtmp.initial_pool_size: Initial Pool Size. Default: 0
• rtmp.max_pool_size: Max Pool Size. Default: 2
• rtmp.max_processor_pool_size: Max Processor Pool Size. Default: 16
• rtmp.executor_keepalive_time: Executer Keep-Alive Time. Default: 60000
• mina.logfilter.enable: Mina Log Filter Enable. Default: false
• rtmp.scheduler.pool_size: Scheduler Pool Size. Default: 16
• rtmp.deadlockguard.sheduler.pool_size: Deadlockguard Scheduler Pool Size. Default: 16
• rtmp.executor.core_pool_size: Executer Core Pool Size. Default: 4
• rtmp.executor.max_pool_size: Executer Max Pool Size. Default: 32
• rtmp.executor.queue_capacity: Executer Queue Capacity. Default: 64
• rtmp.executor.queue_size_to_drop_audio_packets: Executer Queue Size to Drop Audio Packets. Default: 60
• rtmp.max_handling_time: Max Handling Time. Default: 2000
• rtmp.channel.initial.capacity: Channel Initial Capacity. Default: 3
• rtmp.channel.concurrency.level: Channel Concurrency Level. Default: 1
• rtmp.stream.initial.capacity: Stream Initial Capacity. Default: 1
• rtmp.stream.concurrency.level: Stream Concurrency Level. Default: 1
• rtmp.pending.calls.initial.capacity: Pending Calls Initial Capacity. Default: 3
• rtmp.pending.calls.concurrency.level: Pending Calls Concurrency Capacity Level. Default: 1
• rtmp.reserved.streams.initial.capacity: Reserved Streams Initial Capacity. Default: 1
• rtmp.reserved.streams.concurrency.level: Reserved Streams Concurrency Level. Default: 1
• rtmp.max_packet_size: Max Packet Size. Default: 3145728

RTMPS Settings

• rtmps.host: Host value. Default: 0.0.0.0
• rtmps.port: Port value. Default: 8443
• rtmps.ping_interval: Ping Interval. Default: 5000
• rtmps.max_inactivity: Max Inactivity value. Default: 60000
• rtmps.max_keep_alive_requests: Max Keep Alive Requests. Default: -1
• rtmps.max_threads: Max Threads. Default: 20
• rtmps.acceptor_thread_count: Acceptor Thread Count. Default: 2
• rtmps.processor_cache: Processor Cache. Default: 20

RTMPS Key & Truststore

• rtmps.keystorepass: Keystore Password. Default: password
• rtmps.keystorefile: Keystore File location. Default: conf/keystore.jks
• rtmps.truststorepass: Truststore Pass. Default: password
• rtmps.truststorefile: Truststore File location. Default: conf/truststore.jks

RTMPT Settings

• rtmpt.host: RTMP Host. Default: 0.0.0.0
• rtmpt.port: RTMPT Port. Default: 8088
• rtmpt.ping_interval: Ping interval. Default: 5000
• rtmpt.max_inactivity: Max Inactivity. Default: 60000
• rtmpt.max_handshake_time: Max Handshake Time. Default:5000
• rtmpt.max_keep_alive_requests: Max Keep Alive Requests. Default: -1
• rtmpt.max_threads: Max Threads. Default: 20
• rtmpt.acceptor_thread_count: Acceptor Thread Count. Default: 2
• rtmpt.processor_cache: Processor Cache. Default: 20
• rtmpt.encoder_base_tolerance: Encoder Base Tolerance. Default: 5000
• rtmpt.encoder_drop_live_future: Encoder Drop Live Future. Default: true
• rtmpt.target_response_size: Target Response Size. Default: 32768 (For streaming), 8192 (For small messages)
• rtmpt.max_in_msg_process: Max incoming messages to process at once. Default: 166
• rtmpt.max_queue_offer_time: Max queue offer time (ms). Default: 125
• rtmpt.max_queue_offer_attempts: Max queue offer attempts. Default: 4

Debug Proxy (requires activation in red5-core.xml)

• proxy.source_host: Proxy source host. Default: 127.0.0.1
• proxy.source_port: Proxy Source Port. Default: 1936
• proxy.destination_host: Proxy Destination Host. Default: 127.0.0.1
• proxy.destination_port: Proxy Destination Port. Default: 1935

JMX Settings

• jmx.rmi.host: JMX RMI Host. Default: localhost
• jmx.rmi.port: JMX RMI Port. Default: 9999
• jmx.rmi.sport: JMX RMI Sport. Default: 9998
• jmx.rmi.port.remoteobjects: JMX RMI Remote Objects Port. Optional.
• jmx.keystorepass: JMX Keystore Pass. Default: password
• jmx.mina.monitor.enable: Enable Mina Monitor. Default: false
• jmx.mina.poll.interval: Mina Poll Interval. Default: 1000
• jmx.registry.create: Always create registry in-process. Default: true
• jmx.reuse.existing.server: Reuse existing MBean server. Default: true
• jmx.register.factory: Register MBean server with factory. Default:true
• jmx.daemon: Run JMX connector threads as daemon. Default: true
• jmx.threaded: Start JMX connector server in a separate thread. Default:true

Other Server Settings

• so.max.events.per.update: Max events per update. Default: 64
• so.scheduler.pool_size: Scheduler pool size. Default: 4
• keyframe.cache.entry.max: Max keyframe cache entries. Default: 500
• war.deploy.server.check.interval: WAR deploy check interval (ms). Default: 600000
• fileconsumer.delayed.write: Enable delayed file writes. Default: true
• fileconsumer.queue.size: File consumer queue size. Default: 120
• subscriberstream.buffer.check.interval: Buffer check interval (ms). Default:5000
• subscriberstream.underrun.trigger: Underrun trigger threshold. Default: 100
• broadcaststream.auto.record: Enable auto recording of broadcasts. Default: false

Auto Recording (MP4 & HLS)

• broadcastream.auto.record.mp4: Auto record to MP4. Default: true
• broadcastream.auto.record.hls: Auto record to HLS. Default: true

Cluster DB Specifications

• clusterdb.host: Cluster DB host. Default: localhost
• clusterdb.user: Cluster DB user. Optional.
• clusterdb.password: Cluster DB password. Optional.