Top
Self Hosting Whatfix Mobile content
  • 10 Feb 2025
  • 1 Minute To Read
  • Dark
    Light
  • PDF

Self Hosting Whatfix Mobile content

  • Dark
    Light
  • PDF

Article summary

Note

Self Hosting is a Beta feature. To enable the feature, contact support@whatfix.com.

Whatfix Mobile enables you to download the content you have created and host it on your own servers. Self Hosting is useful when you are on an internal network and cannot access the in-app experiences from the Whatfix cloud or when your IT security doesn't enable resource loading from remote servers. With Self Hosting, create the in-app experience on the Whatfix cloud and export it as a .zip file for hosting on your CDN (Content Distribution Network) or private server.

Use the following steps to self ost Whatfix Mobile content:

1. On the Whatfix Mobile Dashboard, select the App containing the Projects you want to export.
dashboard_select_app

2. Click App Settings.
app_settings

3. In the Export Content section, click Export.
export_content2

Info
  • The project you create needs to be published before you export it.
  • After you export the App, an email with a link to download the content is sent to your registered email address.
    export_content_dialog

4. To download the .zip file, go to the email and then click Download Package.
export_package_email

5. Unzip the file and upload the whatfix folder to your server. 

Note
  • The folder name is a UUID (a 36-character alphanumeric string) that contains the whatfix folder. 
  • The whatfix folder includes all the resources and assets required for the SDK to run on Self hosted mode.
Info
  • Here's how the extracted folder looks like:
    Mobile_extracted_folder.png
  • Ensure that you keep the folder structure intact while uploading it to your server.
  • If you update your Whatfix Mobile content, you have to publish it and then export the .zip file again.

6. After uploading the content to your server, add the following code as per your platform while initializing the SDK to fetch Whatfix Mobile content from your CDN or server.

Note

Ensure that the URL ends with a slash('/'). For example, https://xyz.test.com/self-hosting/

Info

The Self Hosting feature is available only for SDK versions equal to and above the following versions:

  • Android: 2.0.10
  • iOS: 2.0.7
  • React Native (Android and iOS): 2.0.10
  • Xamarin (Android and iOS): 2.0.7
  • Cordova (Android and iOS): 2.0.7
  • Ionic: 1.2.0
  • MAUI Android: 2.0.7

Android

String selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.startWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

iOS 

let selfHostingBaseUrl:String = "https://assets.selfhosting.com/self-hosting/"
Leap.shared.withSelfHostedBuilder()?.setBaseUrl(selfHostingBaseUrl)?.start("API_KEY")



MAUI Android

String selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.StartWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

React Native

let selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.startWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

Ionic

let selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.startWithSelfhostingEnabled({apiKey: "API_KEY",baseUrl: selfHostingBaseUrl});

Cordova (Android)

let selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.startWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

Cordova (iOS)

let selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.startWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

Xamarin Android

String selfHostingBaseUrl = "https://assets.selfhosting.com/self-hosting/";
Leap.StartWithSelfhostingEnabled("API_KEY",selfHostingBaseUrl);

Xamarin iOS

let selfHostingBaseUrl:String = "https://assets.selfhosting.com/self-hosting/"
Leap.Shared.WithSelfHostedBuilder()?.SetBaseUrl(selfHostingBaseUrl)?.Start("API_KEY")

Was this article helpful?


Changing your password will log you out immediately. Use the new password to log back in.
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.