Skip to main content
Version: 2.12

Creating a new application

Ant Media Server supports dynamic application development, effectively addressing the multi-tenancy challenges of online video platforms. With three built-in applications, the server allows users to configure distinct settings for each application and customize application names.

To accommodate this, customers can create or delete applications as needed. There are multiple methods available for managing applications, which we will outline below.

Web Panel​

The fastest and easiest way to create new applications on the web panel.

Step 1​

Login to the web panel, on the Dashboard & Click the New Application button

image

Step 2​

Enter application name and click the Create button

image

Note- In cluster mode, the server automatically creates the new application across all nodes in the cluster. Similarly, if an application is deleted, it will be removed from all nodes as well.

Shell Script​

There is a script that creates new applications in Ant Media Server easily. You just need to type a few simple commands.

Let’s have a look at the steps:

Step 1​

Go to the folder where Ant-Media-Server is installed. Default directory is /usr/local/antmedia

cd /usr/local/antmedia

Step 2​

create_app.sh usage in below.

sudo ./create_app.sh -n applicationName -p AMS-Installation-Directory

For example:

sudo ./create_app.sh -n streamHive -p /usr/local/antmedia

You can add some parameters in create_app script. Here are the options:

-n: Name of the application that you want to have. It's mandatory
-p: (Optional) Path is the install location of Ant Media Server which is /usr/local/antmedia by default.
-w: (Optional) The flag to deploy application as war file. Default value is false
-c: (Optional) The flag to deploy application in cluster mode. Default value is false
-m: Mongo DB host. If it's a cluster, it's mandatory. Otherwise optional
-u: Mongo DB user. If it's a cluster, it's mandatory. Otherwise optional
-s: Mongo DB password. If it's a cluster, it's mandatory. Otherwise optional
-h: print this usage

Please check it for more detail: Create App Script

Step 3​

Restart Ant Media Service

sudo service antmedia restart

*This feature is available in Ant Media Server 1.9.0+ versions.

Rest Method​

Create Application​

Web panel has the following REST method to create application.

    @POST
    @Path("/applications/{appName}")
    @Produces(MediaType.APPLICATION_JSON)

It means that you can call the following method to create an application with curl. Please take a look at the answer here to learn how to access web panel REST methods programmatically

    curl -X POST -H "Content-Type: application/json" "https://{YOUR_SERVER_ADDRESS}:5443/rest/v2/applications/myapp"

Delete Application​

Web panel has the following REST Method to delete the application.

    @DELETE
    @Path("/applications/{appName}")
    @Produces(MediaType.APPLICATION_JSON)

Call the following method to delete an application(apptest) with curl.

    curl -X DELETE -H "https://{YOUR_SERVER_ADDRESS}:5443/rest/v2/applications/myapp"