You can get started by either downloading the seed project or if you would like to add Auth0 to an existing application you can follow the tutorial steps.

Download a sample project.

System Requirements

This tutorial and seed project have been tested with the following:

  • NodeJS 5
  • Cordova 5.4 or later

1. Setting Up the Callback URL

Go to the Application Settings section in the Auth0 dashboard and make sure that Allowed Callback URLs contains the following value:


Also, if you are testing your application locally, make sure to add your local URL as an Allowed Callback URL and the following as an Allowed Origin (CORS):


2. Add InAppBrowser Plugin

You must install the InAppBrowser plugin from Cordova to be able to show the Login popup. For that, just run the following command:

cordova plugin add cordova-plugin-inappbrowser

and then add the following configuration to the config.xml file:

<feature name="InAppBrowser">
  <param name="ios-package" value="CDVInAppBrowser" />
  <param name="android-package" value="org.apache.cordova.inappbrowser.InAppBrowser" />

3. Follow the Front End Quickstarts

Follow the quickstart guide for the specific technology you are using in your Cordova app.

Note: Cordova doesn't support getting dependencies from a CDN, so it is necessary to download the JavaScript and CSS dependencies locally and then point to the downloaded files.

Note: You must use popup mode when configuring an application with Cordova. This can be done by setting redirect: false in the options object for Lock. See the Lock customization documentation for more.


Command failed with exit code 65 when running cordova build

This means that the InAppBrowser plugin wasn't installed successfully by Cordova. Try any of the following:

  • Reinstall the InAppBrowser plugin
cordova plugin remove cordova-plugin-inappbrowser
cordova plugin add cordova-plugin-inappbrowser
  • Remove the platform and re add it


cordova platform remove ios
cordova platform add ios


cordova platform remove android
cordova platform add android
  • Copy the contents from the plugin to the platform plugins


cp plugins/cordova-plugin-inappbrowser/src/ios/* platforms/ios/[yourAppName]/Plugins/cordova-plugin-inappbrowser/


cp plugins/cordova-plugin-inappbrowser/src/android/* platforms/android/[yourAppName]/Plugins/cordova-plugin-inappbrowser/

Blank page with an OK after signin

This may be caused by the default setting like below, profile, token) {


You must configure Lock as shown below, to avoid the blank screen popup with the OK button.{sso: false},function(err, profile, token) {


Lock is displaying errors when using cordova serve command

Debug your app inside the simulator for your platform or an actual device. Running Lock from inside a browser using cordova serve is not supported at this time.

Try Auth0 for FREECreate free Account