Skip to main content

Table of Contents

Setting up an alternative host for mobile apps


Only available versions of this content are shown in the dropdown

Configure a mobile app to connect to a specific alternative host name and port instead of the default host name and port of the instance that you use to build your app.

By default, Pega Platform builds mobile apps with the server URL address that results from the context of the App Studio or Dev Studio session that is open in your browser. An example of a scenario that requires a change to that default behavior is when your development instance is only accessible from an internal company network, while the user-facing part of the system is on the public network. Alternatively, there are separate systems for development and production.

Ensure that you import the following components from the instance that you use to build the app, to the one that you want to use as the alternative host:

  • The whole of the Pega application, with unchanged application alias
  • The mobile channel instance
  • The associated OAuth 2.0 client registrations
  • The authentication service that you select in the mobile channel

Additionally, ensure that the following authentication services are enabled in the instance that you want to use as the alternative host:

  • The authentication service that you select in the mobile channel
  • The Mobile authentication service, available in out-of-the-box in Pega Platform

Production instances can have limited access to Pega studios or have all the rulesets locked, which effectively prevents you from building a mobile app on such instances. Therefore, you can build mobile apps on your development or staging instances, and then specify an alternative host name and port that point to the production instance.

  1. Open your mobile channel:

    1. In the header of Dev Studio, click the name of the application, and then click Channels and interfaces.

    2. In the Current channel interfaces section, click the tile that represents a mobile channel for your app.

  2. On the mobile channel page, on the Configuration tab, click the Hosting category.

  3. In the Hosting section, select the Override default host check box.

  4. In the Alternative host field, enter the host name that you want to use.
  5. In the Port field, enter the port for the alternative host URL.

  6. Click Save.

Related Content

Suggest Edit
Did you find this content helpful?

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.

Ready to crush complexity?

Experience the benefits of Pega Community when you log in.

We'd prefer it if you saw us at our best.

Pega Community has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice
Contact us