White Labeling the iOS, macOS, and Android enrollment pages

Getting Started

This article explains how to customize the enrollment page for iOS, macOS (MDM), and Android devices - the enrollment page is what is made visible for your end users when they enroll their devices manually (BYOD or manual enrollment).

Feature Customization type Technology
iOS, macOS MDM, Android Server template HTML
Managed Platform Server Platform Location
Android macOS and Linux /usr/local/filewave/django/user_templates/android/welcome.html
iOS and macOS macOS and Linux /usr/local/filewave/django/user_templates/ios/welcome.html

This HTML document is actually a template, containing variables that will be replaced by the real values when processed by the FileWave server. We are using Django template language - but in a very limited way; only a few variables are important. 

iOS and MacOS

variable usage
static Path where FileWave stores static files like icons, css files
<already_trusted_ca True if the server has a valid, trusted SSL certificate

The template will show one or two steps depending on the SSL certificate your server is using.

In case of self signed certificate:

In case of trusted certificate (recommended):


variable usage
static Path where FileWave stores static files like icons, css files
filewave_version FileWave server current version. "12.4.0" for instance
server_host FileWave server FQDN as set in preferences. "server.filewave.ch" for instance
server_port FileWave server port as set in preferences. 20443 by default.

Android template always shows two steps:

Additional files

Additional files can be placed in the same directory and will be served with the /user_templates/ios/ prefix. For instance, if you want to include a CSS file, you can add to your index.html:

And copy "enroll.css" in the same directory as index.html.

Revision #3
Created 22 June 2023 21:33:20 by Josh Levitsky
Updated 29 May 2024 14:15:33 by Josh Levitsky