Configure Wowza Streaming Engine™ media server software to receive an encoded live stream from an RTMP-based source and play the live stream over all supported streaming protocols.
Video: Connect an RTMP encoder to Wowza Streaming Engine
See how to connect an RTMP encoder to Wowza Streaming Engine to publish and deliver streams.
Before you start
You should complete the following tasks:
- Create a live application according to Create applications.
Configure the live streaming application
Live streams are configured and managed in live applications in Wowza Streaming Engine. You can configure a live application in Wowza Streaming Engine Manager or by setting properties in the application's XML configuration file. Both methods produce the same result.
Configure the live application in Wowza Streaming Engine Manager
- In Wowza Streaming Engine Manager, click the Applications tab at the top of the page and then select your application in the contents panel.
- On the Setup tab of your application's page, make sure all Playback Types are selected.
Note: Every time you edit an application's configuration, Wowza Streaming Engine prompts you to restart the application. However, you can wait until all changes are completed before you restart.
Next, disable playback authentication.
- In the contents panel, click Playback Security, and then click Edit.
- Under Client restrictions, select No client restrictions, and then click Save.
Next, enable source authentication for the encoder.
- In the contents panel, click Source Security, and then click Edit.
- On the Source Security page, under RTMP Sources, select Require password authentication.
- Select one of the options for Client Restrictions. Restricting source publishing to specific IP addresses or blocking source publishing from specific IP address is recommended for security purposes. See Secure incoming sources for more information about these options.
- Click Save and then restart the application.
The application runs whenever Wowza Streaming Engine is running.
Note: For more information about securing source connections to live applications, see Configure security using Wowza Streaming Engine Manager.
You're almost done. To finish, configure the source user name and password to publish to the application.
- Click Server in the menu bar, click Source Authentication in the contents panel, and then click Add Source.
- Enter a Source User Name and Password, and then click Add.
Configure the live application in XML
This section shows you how to configure a live application by editing your application's Application.xml configuration file in a text editor. If you configured a live application in Wowza Streaming Engine Manager, skip this section.
- Navigate to [install-dir]/conf/[application-name] and open Application.xml in a text editor.
- In the <Streams> container element, make sure the <StreamType> property is live. The XML looks like this:
<Streams> ... <StreamType>live</StreamType> ... </Streams>
- Set the <HTTPStreamers> property for the HLS and MPEG-DASH streaming protocols. The XML looks like this:
- Set the <LiveStreamPacketizers> property for HLS and MPEG-DASH streaming. The XML looks like this:
<Streams> ... <LiveStreamPacketizers>cupertinostreamingpacketizer,mpegdashstreamingpacketizer</LiveStreamPacketizers> ... </Streams>
- In the <RTP> container element, make sure playback authentication is disabled by setting the <PlayMethod> property to none. The XML looks like this:
<RTP> <Authentication> ... <PlayMethod>none</PlayMethod> </Authentication> ... </RTP>
- Save your changes and close Application.xml.
- Navigate to [install-dir]/conf/ and open publish.password in a text editor.
- Add a source user name and password to control RTMP source access. Following is an example of the file with the source name publisherName and a password:
# Publish password file (format [username][space][password]) # username password publisherName [password]
- Save your changes and close publish.password.
- Restart Wowza Streaming Engine.
Publish the source stream to Wowza Streaming Engine
In your encoder, enter the following application connection settings, and then click Publish or Start:
- Server URL – rtmp://[wowza-ip-address]/[application-name]
- Stream Name – myStream
- User – publisherName
- password – [password]
To verify that the stream is published, click Incoming Streams for your application in Wowza Streaming Engine Manager, and then click the stream name. Uptime, network throughput, and other information about the published stream appear on the page.
To test playback, you need the playback URLs for your stream and the playback types, or streaming protocols, you want to test. You can get playback URLs from the Test Playback window in Wowza Streaming Engine Manager or by entering information about the stream on the Video Test Players webpage. For more information about playback URLs, see About playing Wowza Streaming Engine streams.
The Test Playback window generates playback URLs for each protocol based on the page you're on when you click Test Playback. You can also edit the Server (IP address or domain name), Stream or Media File Name, and Application fields to update the playback URLs for all protocols as needed.
To play your stream, enter the playback URL into your player or a mobile browser, depending on the playback type. To learn more about stream playback, see the Players and Playback articles.
You can also test playback using the Video Test Players webpage. Select the tab for the protocol you want to test and enter the playback URL above the player. Entering the server (IP address or domain name), stream name, application name, and application type (VOD or live) will also generate the playback URLs for each protocol. Click Start to play your stream, and then click Stop when you're ready to end your test.