Red5 open-source media server

===========

Red5 open-source media server is one of the free live streaming solutions provided by Red5. Written in Java, it features a flexible plugin architecture for building and experimenting with live streaming and video-on-demand (VOD) applications. Learn more about its key features and capabilities here.

Red5 open-source media server supports the RTMP protocol only. It is ideal for developers, hobbyists, and students who want to experiment with open-source live streaming technology, build a media server, and learn how it works.

For production use cases requiring additional protocols and capabilities, Red5 offers licensed commercial live streaming software: Red5 Pro and Red5 Cloud. They support ingest via WHIP, Zixi, RTSP, RTMP, SRT, Enhanced RTMP, MPEG-TS, and MOQ (Media over QUIC), with delivery via HLS, LL-HLS, DASH, LL-DASH, SRT, RTSP, RTMP, and MOQ.

Installed more than 1,000,000 times worldwide, Red5 open-source media server has powered applications for organizations including Amazon, the U.S. Department of Defense, Akamai, Harvard University, and many others. The open-source media server also serves as the server core for Red5 Pro and Red5 Cloud.

Automatic builds (Courtesy of Apache OpenMeetings):

• Red5
• Windows Installer

Developer Community Support

If you have questions regarding the development, there are a couple of places you get help help from fellow developers:Join Red5 Slack community Ask your question on Red5 official subreddit or Stack

Maven

Releases are available at Sonatype - Releases

Snapshots are available at Sonatype - Snapshots

Include the red5-parent in your pom.xml in the dependencyManagement section

<dependencyManagement>
    <dependencies>
      <dependency>
          <groupId>org.red5</groupId>
          <artifactId>red5-parent</artifactId>
          <version>${red5.version}</version>
          <type>pom</type>
      </dependency>
    </dependencies>
</dependencyManagement>  

in addition to any other Red5 projects in the dependencies section

  <dependency>
      <groupId>org.red5</groupId>
      <artifactId>red5-server</artifactId>
      <version>${red5.version}</version>
      <type>jar</type>
  </dependency>

Build from Source

As of release 2.2.0 the target JDK is JDK 25 (Maven 3.6+). If your Maven rc pins an older JAVA_HOME, build with MAVEN_SKIP_RC=1 mvn ....

To build the red5 jars, execute the following on the command line:

mvn -Dmaven.test.skip=true install

This will create the jars in the "target" directory of the workspace; this will also skip the unit tests.

To package everything up in an assembly (tarball/zip):

mvn -Dmaven.test.skip=true clean package -P assemble

Docker RTMP Integration Test

This repo includes an integration test that:

• starts a Red5 server container
• launches 5 concurrent RTMP publishers via ffmpeg
• validates subscriptions with ffprobe
• collects logs and checks for handshake / rejection issues

Prerequisites:

• docker
• ffmpeg
• ffprobe
• Java 25 and Maven

Run against the published image (mondain/red5:latest):

mvn -pl tests -Pdocker-integration -Dred5.it.image=mondain/red5:latest -Dred5.it.autoPull=on -DskipTests=false verify

Run against your current checkout (build + dockerize local version first):

bash tests/src/test/resources/scripts/build_local_red5_docker_image.sh red5-local:dev
mvn -pl tests -Pdocker-integration -Dred5.it.image=red5-local:dev -Dred5.it.autoPull=off -DskipTests=false verify

Artifacts are written to:

tests/target/rtmp-docker-it/<timestamp>/

Key outputs:

• red5-container.log: server logs from the container
• publisher-stream*.log: per-publisher ffmpeg logs
• ffprobe-stream*.json: per-stream probe validation
• handshake-findings.log: handshake-related findings
• connection-rejections.log: connection rejection findings

To build a milestone tarball:

mvn -Dmilestone.version=1.0.7-M1 clean package -Pmilestone

Older Releases

Visit this page to review release notes from all previous versions Releases·Red5/red5-server

Supporters

YourKit supports open source projects with innovative and intelligent tools for monitoring and profiling Java and .NET applications.

Red5 is a trusted live streaming solution provider for developers, startups and enterprises, delivering video, audio, and data with under 250 ms of latency.