AMS application configuration
Ant Media Server can be configured either by editing a configuration file or through the application settings tab in the management console.
The configuration is set on the application level and is stored in a file located at <AMS_DIR>/webapps/<AppName>/WEB-INF/red5-web.properties
.
The management panel allows some changes however, the file is much more extensive. See the Application Settings Javadoc to find a complete list of all available settings.
Management panel settings
Login to the Ant Media Server dashboard and click on the application you want to configure from the left hand menu. Then click on the settings tab.
Highlighted below is how to enable VP8 encoding in the management panel.
Application properties file
To edit the configuration file directly, navigate to the file located at <AMS_DIR>/webapps/<AppName>/WEB-INF/red5-web.properties
and open it using your preferred editor.
Highlighted below is how to enable VP8 encoding by editing the configuration file.
Adding additional settings
If a configuration setting has not been added to the red5-web.properites
file, simply append the setting to the configuration file.
Follow the steps below to add an additional setting:
1. Find the setting
Open the Javadoc page and find the setting that needs to be added to the configuration file.
2. Confirm the setting type and value
The description of each setting confirms the type and default value. For example, the setting aacEncodingEnabled
is of type boolean with a default value of true
:
@Value("${settings.aacEncodingEnabled:true}")
private boolean aacEncodingEnabled
To confirm the function of the setting, additional information is provided in the description .
If aacEncodingEnabled is true, aac encoding will be active even if mp4 or hls muxing is not enabled, If aacEncodingEnabled is false,
aac encoding is only activated if mp4 or hls muxing is enabled in the settings, This value should be true if you're sending stream to
RTMP endpoints or enable/disable mp4 recording on the fly
3 Update the confguration file
To add an additional setting to the configuration file, open the applications red5-web.properties
file located at <AMS_DIR>/webapps/<AppName>/WEB-INF/red5-web.properties
.
Following the example of aacEncodingEnabled
setting, the below can be appended to the file:
settings.aacEncodingEnabled=false