For up-to-date product documentation, see the IBM MobileFirst Foundation Developer Center.

Registering web applications from the MobileFirst Operations Console

We can use the IBM MobileFirstâ„¢ Platform Operations Console to register your web application to an instance of MobileFirst Server.

Before you begin

Run the IBM MobileFirst Platform Operations Console on the same instance of MobileFirst Server to which we want to register your application. For information about how to install the MobileFirst Development Server and run the console, see Installing the IBM MobileFirst Platform Foundation Developer Kit.

Note: We can register an application to the server either before or after you set up your development environment and start developing the application. However, we must register your application before we can call the MobileFirst APIs from your client application and communicate with the server.


  1. In the MobileFirst Operations Console, navigate to the Register Application page by using one of the following methods:
    • In the navigation sidebar, select New next to Appilcations.

      Console navigation-bar app-registration button

    • From the Dashboard, select Register an App.

      Console dashboard app-registration tile

  2. On the Register Application page, provide the required input for registering your web application, as demonstrated in the following image.

    App-registration console page

    1. In the Application Name field, optionally enter a display name for our application (for example, MyApplication). If you do not provide an application name, the application ID is used also as the display name.
    2. In the Choose Platform field, select Web.
    3. In the Application ID field, enter a unique identifier for our application (for example, com.example.myapplication).

      Note: The application ID that is provided during registration must be identical to the value of the applicationId initialization option that is set when initializing the web SDK. For more information, see Initializing the MobileFirst SDK.

  3. Select Register application to complete the registration.


When the application is successfully registered to the target server, we can select it from the Applications section in the navigation sidebar of the MobileFirst Operations Console (under Versions or Web). The main application page displays different server-side configuration options for your application.

In the application Configuration Files console tab, we can see the content of the application's descriptor and runtime configuration files. The value of the applicationId in the application descriptor is the application ID that you specified when you registered the application.

Note: We cannot have multiple versions of the same web application. Therefore, the applicationKey object of the application descriptor does not contain a version property.

What to do next

We can proceed with other development tasks that depend on MobileFirst Server, such as making server-side configurations, testing the application's security features, and managing the application from the MobileFirst Operations Console.

Make sure to initialize the SDK from your application before calling any SDK APIs other than the initialization method. For more information, see Initializing the MobileFirst SDK.

Parent topic: Registering web applications to MobileFirst Server