Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Setting up an alternative host for mobile apps

Updated on April 27, 2022

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.
Before you begin:

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 checkbox.
  4. In the Alternative host field, enter the host name that you want to use.
    For example:
  5. In the Port field, enter the port for the alternative host URL.
    For example: 8080
  6. Click Save.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us