Installing Android kiosk will ensure that the Cloudshelf will be locked to the screen and will auto-launch as soon as the device is plugged in. It also prevents customers / children from exiting the app by accident.


Please note: Setup should take around 10 minutes per device.


1. Connect to wi-fi on the device & log in to play store with your credentials.


2. Before Installation:

Open Google Play and ensure that Google Chrome is fully up to date. Ideally version 106.X or above.  Cloudshelf will not run at all on any version prior 63.


3. There are two installation methods to install Android kiosk to the device:

  • You can choose to install via an APK and the latest version can be downloaded by clicking here, alternately you can install it via Google Play store.
  • You'll need to purchase a one off licence for $6 per device to keep Android kiosk running.

4. Installation:


Once you have installed the APK, do not press OPEN, instead press DONE.
Now press your home button, and you may be asked to "Select a home App", in our cause we see:

  • Kiosk Browser
  • TouchWiz Home
  • Kids Mode
  • You will need to click on the default stock launcher, for us, this is “TouchWiz Home", but this will not be the case on devices not manufactured by Samsung.
  • Now use the normal Android interface to find the "Kiosk Browser" application, and follow the on-screen instructions to grant all the permissions, when it takes you to a settings page, change the permission it asked for and then use the hardware/software back button to get back to the permissions screen. Note: This is a recursive process and so you WILL have to do this multiple times.
  • After these permissions are granted, it should ask you if the app can be a Device Administrator, you must also grant this.
  • Finally, it will ask you to "Select a Home app" again, this time you want to select "Kiosk Browser", if it does not ask you to do this, just use the normal android interface to find the “Kiosk Browser“ application and open it.

5. Configuration:

  • Now you have the application installed, you need to configure it. If the application is trying to give you a guided tour, just press SKIP in the bottom left; this should then load Google.
  • In the top right-hand corner, there will be three vertical dots, click this and then click settings.
  • Enter the password 0000,and click OK.
  • Click on Advanced -> Automatic Config URL, and set it tocloudshelf.ai/device/androidkiosk.json
  • Ensure you are back in the main settings menu (it has the title Settings), if you don’t see this title then press back (it’s the arrow in the top left).
  • Now click on Admin -> Download Automatic Config,it will appear as if nothing has happened, but don't be alarmed this is normal. Now press back to go back to the main settings window.
  • That's it! All done.


6. Confirm that the config was set correctly:

  • Click General, and under Kiosk URL you should see https://device.cloudshelf.ai
  • Once set up is complete, go to > settings > advanced > automatic config url > delete (set to blank). 
    This last step is to allow the customer to update any settings without having them overridden by Cloudshelf's default.



7. How to exit kiosk mode:


  • Tap 4 times quickly in the same spot, and then enter the password you configured in the settings; if you didn't change it it's0000.


8. Save the device URL to the home screen & email us the pairing code: 

  • Pair the device on the Cloudshelf app by clicking onto 'Devices' and selecting the Cloudshelf you wish to display or please email the pairing code to sofia@cloudshelf.ai and we will pair the device for you.


9. Before shipping out the device 

  • Please go to settings > users and accounts > remove account from this device.