Since the FileWave process runs at root or system level on computers, the end user does not need to be a local administrator in order to install applications and content through the Kiosk.
### Computer Clients User access to the Kiosk is by way of a macOS Menu Bar or Windows System Tray icon. The Kiosk is activated on computers by installing the FileWave client and having at least one Fileset configured as a Kiosk item associated with that Client.If no association exists, the macOS Menu Bar or Windows System Tray will not include the Kiosk icon
If an association does exist, the icon may still not show; operating system may have rules regarding the quantity of icons displayed, for example. If exceeded, the Operating System chooses which icons remain visible.
It is possible to trigger the Kiosk to show by way of command line, as highlighted in the following KB: [Manual Trigger of FileWave Kiosk for macOS and Windows (15.3+)](https://kb.filewave.com/books/kiosk/page/manual-trigger-of-filewave-kiosk-for-macos-and-windows-153)
### Mobile clients User access to the Kiosk is by way of an automated installed App, FileWave App Portal app. The Kiosk is activated on a mobile device when that device enrolls with the FileWave MDM. ### Associations Any Fileset (including App Store Apps) can be configured as Kiosk items in FileWave Admin, each of which may be added to unique categories, such as a specific department or class, or just by application type. #### Apple VPP An Apple VPP Kiosk item contains the link to the store. The application or book is downloaded from Apple, directly to the device, when the user clicks Install.VPP licences can only be returned for re-use, if the existence of any association or deployment is removed, be that standard or kiosk.
## Mobile Kiosk versus Desktop Kiosk - Mobile: [FileWave Kiosk for iOS/iPadOS overview (15.3+)](https://kb.filewave.com/books/kiosk/page/filewave-kiosk-for-iosipados-overview-153 "FileWave Kiosk for iOS/iPadOS overview (15.3+)") - Desktop: [FileWave Kiosk for macOS and Windows overview (15.3+)](https://kb.filewave.com/books/kiosk/page/filewave-kiosk-for-macos-and-windows-overview-153 "FileWave Kiosk for macOS and Windows overview (15.3+)") ## Related Content - [Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)](https://kb.filewave.com/books/kiosk/page/setting-the-primary-colour-name-and-logo-in-kioskapp-portal-160 "Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)") - [Applications Preventing Reboot (macOS/Windows)](https://kb.filewave.com/books/kiosk/page/applications-preventing-reboot-macoswindows "Applications Preventing Reboot (macOS/Windows)") # FileWave Kiosk for macOS and Windows overview (15.3+) This article will explain the details of the refreshed Kiosk for macOS and Windows that is included in FileWave 15.3+. ## Browse Payloads/Filesets The "Browse Payloads/Filesets" screen is a central feature within the app that enables users to explore and discover a diverse array of payloads/filesets available for access or download. Much like the experience of browsing through the Android Play Store or the Apple App Store, this screen offers users an organized and visually appealing interface that showcases different payloads/filesets, each accompanied by relevant details and information. Key components and elements commonly found on the "Browse Payloads/Filesets" screen include: - **Company Logo:** The visual representation of the company's logo, reinforcing brand identity and providing a familiar visual reference. - **Device Info:** A button leading to the "Device Information" page provides users with quick access to essential insights about specific devices, such as company details, enrollment information, verification status, and app version. - **Payload/Fileset icon:** Each payload/fileset is represented by an icon that provides a visual cue of its content or purpose. - **Payload/Fileset Name:** The name of the payload/fileset is displayed alongside the corresponding thumbnail. This gives users a quick understanding of the payload's/fileset's context. - **Install/Uninstall Button:** This view includes an "Install"/”Uninstall” button that users can click to initiate the installation/uninstallation process of the selected payload/fileset, streamlining the user's interaction and providing a clear call to action. - **Reinstall Button:** This button is visible in two cases (for non-VPP filesets): - When the user tried to install fileset, and installation failed for some reason: - When the fileset is already installed on the device. - **Button Behavior:** The installation process is now accompanied by clear button states, reflecting the various stages: - **Install:** Initiates the installation process. - **Requested:** Indicates that an installation request is pending. - **Uninstall:** Allows users to uninstall the selected payload/fileset. [](https://kb.filewave.com/uploads/images/gallery/2024-04/8bmUA9XWoYX1TJyd-image.png) - **Number of items:** The number of items shows how many items are visible on the screen. - **Search Box:** A search box is conveniently integrated, empowering users to quickly locate specific payloads/filesets based on keywords. This feature enhances precision and accelerates the search process. - **Scalable Left Sidebar:** Responding to user preferences, the left sidebar is now scalable, allowing users to customize its width, expanding or minimizing it based on their preference. This flexibility enables users to optimize their workspace, with the left sidebar scalable up to 50% of the screen size. [](https://kb.filewave.com/uploads/images/gallery/2024-04/cECiQXVrVtxHiqjU-image.png) [](https://kb.filewave.com/uploads/images/gallery/2024-04/9qccCLr1EiLuDF6w-image.png) - **Left Side Menu:** Categories are prominently featured in the left side menu, allowing users to effortlessly navigate and filter payloads/filesets based on their specific interests. This user-friendly approach enhances efficiency and ease of use. Double click, or clicking on the icon on the left side of the category will expand the category and subcategories will be shown. - **Statuses Filter:** Filter payloads/filesets based on their installation status (Installed, Not Installed). - **Types Filter:** Tailor the view by filtering payloads/filesets according to types such as "Applications," "Books," "Documents," and more. These enhancements not only simplify the user experience but also provide a comprehensive set of tools for effective payload/fileset management. By incorporating these features, we aim to empower users with a more personalized and efficient approach to navigating and managing their payloads/filesets within FileWave. - **Payload/Fileset Cards:** Each payload/fileset is usually presented as a card containing its icon and name. Tapping on a card leads to a more detailed page for the payload/fileset. - **Pagination:** If there are numerous payloads/filesets available, an infinite scrolling mechanism helps users navigate through multiple pages of listings. - **Scrolling Animations:** Fluid scrolling animations and transitions contribute to a smooth browsing experience, enhancing users' engagement while exploring different payloads/filesets. - **Loading Animation:** During data retrieval, a loading animation provides users with visual feedback, indicating that the app is actively fetching and populating the content. - **Error Handling:** Robust error handling mechanisms ensure that clear and user-friendly error messages guide users in case of connectivity issues or technical glitches. - **Flags for Enhanced Communication**: In the pursuit of transparent communication, we've introduced flags that offer clear insights into specific aspects of payloads/filesets. These flags include: - **Restart Needed:** A flag signaling that the installation or update of a payload/fileset requires a system restart for the changes to take effect. This ensures users are promptly informed about necessary actions for seamless functionality. - **Software Update:** This flag indicates that the payload/fileset represents a software update. Users will receive relevant messages, guiding them through the update process and ensuring they stay informed about crucial software enhancements. [](https://kb.filewave.com/uploads/images/gallery/2024-04/xuz6xYX7vNhUTIKS-image.png) [](https://kb.filewave.com/uploads/images/gallery/2024-04/Oj1gvhS7gIHoST8u-image.png) - **VPP support (macOS):** - **JOIN Modal for Organization Selection:** - macOS users accessing the JOIN section will encounter a modal displaying a comprehensive list of organizations available for joining. This intuitive interface simplifies organization selection and facilitates seamless integration with VPP. - **Streamlined Registration Process:** - Upon selecting the "Join" button, macOS users will seamlessly transition to the App Store app to complete the registration process. This streamlined workflow minimizes user effort and enhances efficiency in finalizing organization registration. - **Dynamic Organization Visibility:** - Upon successful registration with an organization, it will be automatically removed from the list of available organizations. This dynamic update ensures that macOS users are presented with accurate and relevant options, optimizing their selection process. - **User-Friendly Interface:** - If there are no more organizations available for joining, the list at the bottom right will intelligently hide, providing a cleaner interface for macOS users. This decluttered view enhances user experience and facilitates focused decision-making. - **Compatibility with VPP Versions:** - Registration functionality is fully compatible with both VPP v1 and VPP v2, ensuring seamless integration and operation across different VPP versions for macOS users. - **Error handling (in case installation failed):** - Icons with error text tooltips are shown in the Apps List page, providing users with quick access to error information. [](https://kb.filewave.com/uploads/images/gallery/2024-04/C6SVzqHerxpNGqz5-image.png) ## Payload/Fileset details view We are excited to introduce significant enhancements to the Desktop Kiosk versions, mirroring the user-centric improvements made for iOS/iPadOS. With these updates, users can expect a more intuitive and informative experience when interacting with filesets and payloads on their desktop devices. **Key Features:** - **Details View Redesign:** - The "Details View" on Desktop Kiosk now mirrors the comprehensive and informative interface seen on iOS/iPadOS. Users encounter a screen that offers in-depth information about selected filesets/payloads, empowering them to make informed decisions. - **Key Elements and Components:** - **Fileset/Payload Icon:** Visual identifiers help users quickly recognize the selected fileset/payload. - **Fileset/Payload Name:** Clear titles provide clarity about the content or purpose. - **Creator Information:** Details about the developer or source establish credibility and context. - **Description:** Comprehensive descriptions outline functionality, features, and benefits. - **Information:** Users can access details like the last update date, version, and size of the fileset. - **User Interaction Buttons:** Interactive buttons allow users to initiate actions such as installation, with progress updates visible until completion. - **Return to Browse:** A back button facilitates seamless navigation back to the previous browsing screen. - **Scrolling Animations:** Fluid animations enhance the browsing experience, providing engaging transitions between content. - **Loading Animation:** Visual feedback informs users of data retrieval processes, ensuring they are aware of ongoing operations. - **Error Handling:** Robust error messages guide users through connectivity issues or technical glitches, maintaining a smooth user experience. [](https://kb.filewave.com/uploads/images/gallery/2024-04/M7G90wXPSmRVq8Pf-image.png) These enhancements aim to streamline the desktop browsing experience, aligning it closely with the intuitive interface seen on iOS/iPadOS. By providing users with comprehensive information and intuitive navigation, the Desktop Kiosk versions empower users to make informed decisions and maximize productivity. ## Device Information view We're thrilled to unveil enhancements to the Device Information view on Desktop Kiosk, paralleling the user-centric improvements made for iOS/iPadOS. This revamped interface provides users with a comprehensive overview of vital device details, fostering transparency and effective management within the app's ecosystem. **Key Features:** - **Header Navigation:** - Users can easily navigate back to the Browse Apps view using the back button located in the header, ensuring seamless transitions between different sections. - The last verified date provides users with the latest verification status of the device, facilitating real-time monitoring. - A prominent "Verify Device" button in the header enables users to manually trigger a device verification process, ensuring up-to-date validation. - **Device Information Section:** - The "Device Information" page now offers an exhaustive display of essential device details, empowering users with crucial insights. This section includes: - Name: Unique identifier for the device. - Address: Network address associated with the device. - Version: Operating system version installed on the device. - Platform: Platform type (e.g., Windows, macOS). - Model Version: Device model information. - Tickle Interval: Frequency of communication between the device and the server. - File Check Interval: Interval for checking file updates or changes. - **Server Information Section:** - Additionally, users can access pertinent server-related information for seamless integration. This section comprises: - FileWave Server (IP Address): Server address for file management. - SSL: Indication of Secure Socket Layer (SSL) protocol status. - Status: Current server connection status. - Server Connection: Details about the server connectivity. - **Booster Section:** - Users can now conveniently view and manage boosters directly from the Desktop Kiosk interface. This section presents a comprehensive list of boosters along with their corresponding IP addresses, streamlining booster management tasks. These enhancements bolster transparency and facilitate efficient device management within the Desktop Kiosk environment. By providing users with a holistic overview of device and server information, coupled with booster management capabilities, the Desktop Kiosk version empowers users to make informed decisions and optimize their workflows with ease. [](https://kb.filewave.com/uploads/images/gallery/2024-04/XeWLxscCLy8V6tnV-image.png) ## Logo and primary color selection The Adding Logo and Primary Color Selection feature enhances customization within the app by enabling users to personalize the visual representation of their profiles or entities. This feature allows users to define their brand identity and establish a cohesive look and feel throughout the app. Here's how the feature works: - **Logo Upload:** Users can upload their company or entity logo, which serves as a distinctive visual identifier. The logo could be in various formats, such as JPEG, PNG,... Once uploaded, the logo is displayed in relevant sections of the app where the user's profile or entity is showcased. - **Primary Color Selection:** Users can choose a primary color that resonates with their brand's identity. This color becomes the dominant hue used for interface elements such as buttons, headers, and accents throughout the app. Users can select the color from a color palette or enter a custom color code. - **Visual Consistency:** The uploaded logo and selected primary color are applied consistently across various sections of the app. This ensures a coherent and visually pleasing experience for users and anyone interacting with their profiles or entities within the app. - **Personalization:** By allowing users to upload their logos and select a primary color, the app offers a personalized touch, making users' presence and contributions stand out within the app's environment. - **Branding Impact:** The combination of a unique logo and primary color strengthens brand recognition and recall, creating a strong visual association with users' profiles or entities. - **User-Friendly Interface:** The process of adding a logo and selecting a primary color is designed to be intuitive, with clear instructions and user-friendly controls that guide users through the customization process. - **Flexibility:** Users can update or modify their logo and primary color selection at any time to reflect changes in their branding or preferences. The "Add Logo and Primary Color Selection" feature empowers users to infuse their identity into the app's interface, enhancing recognition, and contributing to a personalized and engaging experience for both users and their audiences. ## Related Content - [App Portal / Kiosk v2 transition](https://kb.filewave.com/books/kiosk/page/app-portal-kiosk-v2-transition "App Portal / Kiosk v2 transition") - [Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)](https://kb.filewave.com/books/kiosk/page/setting-the-primary-colour-name-and-logo-in-kioskapp-portal-160 "Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)") # FileWave Kiosk for iOS/iPadOS overview (15.3+) ## What The [Self-Service Kiosk](https://kb.filewave.com/books/kiosk/page/self-service-kiosk-overview "Self-Service Kiosk Overview") is FileWave's self-service experience for iOS and iPadOS devices. It lets users browse Kiosk-associated applications, profiles, books, and other approved content without IT having to assign every item directly to each iPad or iPhone. The newer iOS/iPadOS Kiosk experience started with [FileWave 15.3](https://kb.filewave.com/books/downloads/page/filewave-version-1531-unsupported), but the deployment method changed again in **FileWave 16.3.0**. On 16.3.0 and later, the iOS/iPadOS Kiosk is the **Apple App Store** version of FileWave Kiosk, deployed as a **VPP / Apps and Books** app. This article focuses on the Kiosk interface and user experience after the app is installed. For deployment, upgrade behavior, and the required **ASM/ABM** app-license preparation for 16.3.0+, use [Automatic updating of iOS/iPadOS Kiosk (15.3+)](https://kb.filewave.com/books/kiosk/page/automatic-updating-of-iosipados-kiosk "Automatic updating of iOS/iPadOS Kiosk (15.3+)") as the source of truth. ### Important for FileWave 16.3.0 and later - the iOS/iPadOS Kiosk is delivered from the Apple App Store as a VPP / Apps and Books app - FileWave must be syncing with **Apple School Manager (ASM)** or **Apple Business Manager (ABM)** - the **FileWave Kiosk** app must already be acquired there if you want the transition to happen promptly after upgrade ## When/Why The transition from Technical Preview version 15.1 to the Production version 15.3 of our app signifies a major leap forward in terms of user experience and visual appeal, much like the transformation seen when comparing the Android Play Store and the App Store. In this upgrade, the primary focus has been on completely revamping the user interface (UI) to provide a sleek, modern, and highly intuitive platform that caters to our users' evolving expectations. With version 15.3.1, the app undergoes a stunning visual makeover, drawing inspiration from the aesthetic excellence of both the Android Play Store and the App Store: 1. **Unified Design Paradigm:** Our new UI design unifies elements from both the Android Play Store and the App Store, creating a harmonious blend of familiarity and innovation. This design consistency ensures that users across various platforms feel comfortable while navigating the app. 2. **Intuitive Navigation:** Introduces a reimagined navigation system. Users can effortlessly explore and discover content thanks to intuitive menus, recognizable icons, and seamless navigation flows, akin to the ease of navigation in both app marketplaces. 3. **Visual Delight:** The new UI is not just about functionality; it's a visual treat. Engaging animations, subtle transitions, and tastefully curated visuals combine to make every interaction with the app a delightful experience, echoing the immersive nature of the Android Play Store and the App Store. 4. **Enhanced Customization:** Introduces enhanced customization options, allowing users to personalize their interface just as they would within the Android Play Store and the App Store. Users can arrange and prioritize content according to their preferences, granting them a sense of ownership over their app experience. 5. **Responsive Design:** Much like the Android Play Store and the App Store's responsiveness across devices, our app now adapts seamlessly to various screen sizes and orientations. This ensures a consistent and optimized experience whether users are browsing on smartphones, tablets, or desktops. By transitioning to the 15.3 release of the Kiosk, with a UI overhaul reminiscent of the Android Play Store and the App Store, our app solidifies its commitment to delivering an unparalleled user experience. This transformation isn't just about aesthetics; it's a testament to our dedication to meeting the evolving needs of our users in an engaging, intuitive, and visually striking manner. As we bridge the gap between the old and the new, version 15.3 sets the stage for a future where our app continues to evolve in tandem with user expectations and industry trends. ## How ### Browse Payloads/Filesets The "Browse Payloads/Filesets" screen is a central feature within the app that enables users to explore and discover a diverse array of Payloads/Filesets available for access or download. Much like the experience of browsing through the Android Play Store or the Apple App Store, this screen offers users an organized and visually appealing interface that showcases different Payloads/Filesets, each accompanied by relevant details and information. Key components and elements commonly found on the "Browse Payloads/Filesets" screen include: - **Company Logo:** The visual representation of the company's logo, reinforcing brand identity and providing a familiar visual reference. - **Device Information:** A button leading to the "Device Information" page provides users with quick access to essential insights about specific devices, such as company details, enrollment information, verification status, and app version. - **Payload/Fileset icon:** Each Payload/Fileset is represented by icon that provides a visual cue of its content or purpose. - **Payload/Fileset Name:** The name of the Payload/Fileset is displayed alongside the corresponding thumbnail. This gives users a quick understanding of the payload's/Fileset's context. - **Install Button:** This view includes an "Install" button that users can click to initiate the installation process of the selected Payload/Fileset, streamlining the user's interaction and providing a clear call to action. If the Payload/Filesets is already installed, button will not be visible. - **Category Filters:** Users can typically filter Payloads/Filesets by Types such as "Applications," "Books," "Documents," and more. Filtering is possible by Categories (these should be configured in FileWave Central) and also by Status (Installed, Not Installed). This categorization helps users narrow down their search based on their specific interests.| iPhone | iPad |
| [](https://kb.filewave.com/uploads/images/gallery/2023-09/7u5iVMTf20H10LJH-image.png) | [](https://kb.filewave.com/uploads/images/gallery/2023-09/TVD2xpxNRhqaEUK4-image.png) |
| iPhone | iPad |
| [](https://kb.filewave.com/uploads/images/gallery/2023-09/kqRlOklF3VXG7xh0-image.png) | [](https://kb.filewave.com/uploads/images/gallery/2023-09/YSgdFSmLSdfi72di-image.png) |
| iPhone | iPad |
| [](https://kb.filewave.com/uploads/images/gallery/2023-09/EMz1SoOzzdY5tE2Y-image.png) | [](https://kb.filewave.com/uploads/images/gallery/2023-09/bMJRDO676usCTd6p-image.png) |
| iPhone | iPad |
| [](https://kb.filewave.com/uploads/images/gallery/2023-09/PiGkmZbXJ58GGlEs-image.png) | [](https://kb.filewave.com/uploads/images/gallery/2023-09/U0YXtgRwtQMy69Ui-image.png) |
AS of FileWave 16+, the FileWave Kiosk v1 will be removed from computer devices, with Kiosk v2 being the only option.
**Key Points:** 1. **From Technical Preview to Real App:** In previous releases, App Portal for iOS/iPadOS was introduced as a technical preview, allowing users to explore its functionalities and provide valuable feedback. With version 15.3.0, we are thrilled to elevate App Portal to the status of a fully-fledged, official application. 2. **Enhancements and Stability:** The transition signifies not only the culmination of user feedback but also substantial enhancements and optimizations to ensure the stability, reliability, and performance of the App Portal for iOS/iPadOS. 3. **A Seamless User Experience:** Users can now enjoy a seamless and refined experience with App Portal, harnessing its full potential for efficient and intuitive mobile application management.5.3.0 and beyond. ### Desktop Kiosk for macOS and Windows The transition from App Portal version 15.0.0 to version 15.3.0 represents a significant evolution, akin to the transformative experience observed when comparing the Android Play Store and the App Store. This upgrade places a primary emphasis on completely overhauling the user interface (UI) to provide a sleek, contemporary, and exceptionally intuitive platform, aligns with our users' evolving expectations. While version 15.0.0 laid the groundwork for functionality, version 15.3.0 responds to user feedback and industry trends, recognizing the demand for a more sophisticated and streamlined UI. Here's how the new version draws inspiration from the design excellence of both the Android Play Store and the App Store: 1. **Unified Design Paradigm:** The UI design seamlessly unifies elements from both the Android Play Store and the App Store, creating a harmonious blend of familiarity and innovation. 2. **Intuitive Navigation:** Building on the success of version 15.0.0, version 15.3.0 introduces a reimagined navigation system with intuitive menus, recognizable icons, and seamless flows, akin to the ease of navigation in both app marketplaces. 3. **Visual Delight:** The new UI isn't just functional; it's a visual delight with engaging animations, subtle transitions, and tastefully curated visuals, providing an immersive experience similar to the Android Play Store and the App Store. 4. **Enhanced Customization:** Version 15.3.0 brings enhanced customization options, allowing users to personalize their interface similar to the Android Play Store and the App Store, fostering a sense of ownership over their app experience. 5. **Responsive Design:** Like the responsiveness of the Android Play Store and the App Store across devices, our app now adapts seamlessly to various screen sizes, ensuring a consistent and optimized experience. Additionally, with version 15.3.0, we've introduced some enhancements. Users will now receive clear indications when installing certain filesets that a reboot is required for optimal performance. This improvement ensures transparency and empowers users with the necessary information for a seamless experience. By incorporating these enhancements, App Portal solidifies its commitment to delivering a cutting-edge, user-friendly experience that aligns with evolving user expectations and industry trends. Version 15.3.0 sets the stage for a future where App Portal evolves dynamically, staying at the forefront of user-centric innovation.Please note that there are some pre-15.3 customizations that no longer have any effect as well as one customization that can result in seeing both the old and new Kiosk on a macOS or Windows system. Please review the related content below.
## Related Content - [Removing pre-15.3 Kiosk Customizations (macOS/Windows)](https://kb.filewave.com/books/kiosk/page/removing-pre-153-kiosk-customizations-macoswindows "Removing pre-15.3 Kiosk Customizations (macOS/Windows)") - [Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)](https://kb.filewave.com/books/kiosk/page/setting-the-primary-colour-name-and-logo-in-kioskapp-portal-160 "Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)") - [Applications Preventing Reboot (macOS/Windows)](https://kb.filewave.com/books/kiosk/page/applications-preventing-reboot-macoswindows "Applications Preventing Reboot (macOS/Windows)") # FileWave App Portal for iOS (IPA Install)For FileWave 15.3.0+ please note that the IPA is automatically deployed. Once 15.3.0 is released please see: [Automatic updating of iOS/iPadOS Kiosk (15.3+)](https://kb.filewave.com/books/kiosk/page/automatic-updating-of-iosipados-kiosk "Automatic updating of iOS/iPadOS Kiosk (15.3+)")
Once an iOS/iPadOS device is enrolled, the FileWave App Portal will be automatically installed. The version installed after enrollment is a Web Based Application, allowing users to self-install associated Applications, Profiles, and Books or trigger a Verify. FileWave offers an Enterprise version of the App Portal, which is available from the FileWave Download pages (there should be a version to match the server release). The Enterprise version additionally offers: - [Location Tracking](https://kb.filewave.com/books/filewave-client/chapter/location-tracking "Location Tracking") (Limitations apply) - [TeamViewer Notifications](https://kb.filewave.com/books/teamviewer/page/teamviewer-iosipados-client-setup "TeamViewer: iOS/iPadOS Client Setup")Location Tracking relies upon the user accepting both Location Tracking and allowing the FileWave App Portal access to the location data. If users do not accept these, no Location Data will be received. These are limitations imposed by Apple.
The IPA is signed for a year on creation. The signature is renewed by FileWave for versions that are still supported. It is therefore necessary to re-download the Enterprise version and redistribute it, prior to or at the time of expiry, for the App to continue to function. The Web App version has no such consideration.
## Installing the Enterprise FileWave App Portal ### Requirements - iOS IPA available from [FileWave Downloads](https://kb.filewave.com/books/downloads "Downloads") ### Creating the Enterprise FileWave App Portal Fileset From the FileWave Admin application, navigate to: - Filesets > New Mobile Fileset > Enterprise Two options are available: - Import a local .ipa file - Use a remote .ipa file  #### Local File The IPA may be downloaded from the FileWave downloads page. Select the IPA version to match the FileWave Server version.  From the Fileset creation window, browse to the location of the downloaded file, choose 'Import' and then 'Done' #### Remote File The file may be placed in a remote location. This could be either a chosen server or directly from the FileWave Download site.  #### Remote Server If using a chosen server, download the IPA as above, import it into the chosen server, and add the URL path to the Fileset. #### FileWave Download Site If using the FileWave Download site, use the provided static path from the Downloads page as the URLIt is also possible to tick the box to 'Use FileWave MDM server to host the file'. This is essentially the same as the local process. FileWave will then pull the IPA from the download to create a local file for distribution from the FileWave Server.
#### Remote vs Local Considerations ##### **Local** The FileWave server is used to host the IPA, the IPA is directly stored on the FileWave Server and delivered from the FileWave Server to devices. This option has the following considerations: - iOS devices quantity is high ( >1,000 ) and external traffic should be kept to a minimum - No downstream internet connection usage, potentially upstream usage if the FileWave MDM server is exposed to the internet, and devices are outside the internal network. ##### Remote The FileWave Server does not store the IPA, but instead sends the device details of where to pull the IPA. Considerations in this instance are: - iOS devices quantity is high ( >1,000 ) and to avoid saturating the FileWave MDM Server with requests for the IPA - It is not a concern that each device will make its own connection to the download location - Light on the FileWave MDM Server, since load and speed of distribution relies on the downstream internet connection to devices. ## Deploying the Enterprise FileWave App Portal Fileset Deployment of the IPA is as simple as creating an association, either directly or via a group. On receipt of the IPA Fileset, the device will automatically remove the Web App Portal and it will be replaced with the IPA version. Similarly, if providing an updated version, the new version may be associated and the old association removed. ### User Experience It should be expected the user will receive the following prompts, due to TeamViewer integration:  They should also expect to receive the following due to Location Tracking:  Additionally, they should be prompted regarding the ability to continue Location Tracking when the App is not in use: Location Tracking also relies upon the device being configured as such, as highlighted in the KB: [Location Tracking](https://kb.filewave.com/books/filewave-client/chapter/location-tracking "Location Tracking")
## App Portal IPA Removal If it is chosen that the IPA is no longer a requirement, removal of the association for the IPA will not only remove the IPA but the Web App version will once again be automatically deployed to devices. ## IPA Expiry If the installed App Portal IPA is allowed to expire, the App will fail to launch and the users will be prompted:  Deploying a newly downloaded IPA to devices should address this. # Automatic updating of iOS/iPadOS Kiosk ## What FileWave Kiosk on iOS and iPadOS is the self-service application that lets users open Kiosk, view Kiosk-associated content, install available items, and trigger actions such as Verify. Starting with **FileWave 16.3.0**, the current delivery method for iOS/iPadOS Kiosk is the **Apple App Store** version of the app, deployed as a **VPP / Apps and Books** app. As long as FileWave is correctly syncing with **Apple School Manager (ASM)** or **Apple Business Manager (ABM)** and the required **FileWave Kiosk** licenses have already been acquired there, the FileWave server will push the App Store Kiosk to managed devices and replace the older Kiosk. App Store listing: [FileWave Kiosk on the Apple App Store](https://apps.apple.com/lv/app/filewave-kiosk/id6754608883) ## When/Why This is the current and recommended behavior for **FileWave 16.3.0 and later**. The move to the App Store / VPP model aligns Kiosk deployment with Apple's current best practices and with the way other MDM and UEM platforms typically deliver managed iOS and iPadOS applications. The most important operational change is that administrators should not treat the Kiosk upgrade as fully self-contained anymore. Before upgrading to FileWave 16.3.0 or later, make sure FileWave is connected to ASM/ABM for app-license sync and that enough free **FileWave Kiosk** licenses have already been obtained. If those preconditions are in place, the transition is straightforward. If they are not, Kiosk deployment can be delayed or fail to appear when expected. The steps below describe the **current behavior in FileWave 16.3.0 and later**. If you are still running **FileWave 15.3.0 through 16.2.x**, or need to compare the older workflow, see the reference section later in this article. ## How ### Current behavior in FileWave 16.3.0 and later Before upgrading to FileWave 16.3.0 or later: - make sure FileWave is syncing Apps and Books / VPP licenses from **ASM** or **ABM** - acquire free licenses for **FileWave Kiosk** in ASM/ABM before the upgrade - obtain licenses for **more devices than are currently managed** so normal growth does not create an avoidable shortage A practical example is to acquire about **1500 licenses** if you currently manage **1000 devices**. If the licenses are already present before the upgrade, devices remove the older enterprise Kiosk and install the new App Store Kiosk shortly afterward, typically within a few minutes. **Upgrade note for customers coming from 16.2.x:** If you acquire the **FileWave Kiosk** licenses and sync Apps and Books before the server upgrade while still on **16.2.x**, FileWave may prompt you to create an `iOS App - FileWave Kiosk` fileset. That legacy fileset is **not required** for the **16.3.0+** App Store Kiosk workflow. - There is no fileset or fileset association required for normal iOS/iPadOS Kiosk deployment in **16.3.0 and later**. - If the old `iOS App - FileWave Kiosk` fileset still exists after the upgrade, you can leave it unassociated or delete it. - Do not create a new association, or keep an existing one, just to make the **16.3.0+** workflow function. - If that legacy fileset was already associated, remove the association or delete the fileset after the upgrade. Doing so does not break the new App Store Kiosk deployment flow. If the licenses are only acquired after the upgrade, the change is less immediate. In that case, purchase the licenses, run a **Model Update**, and then **Verify** the affected devices. If some other model change is made and pushed, that should also trigger verification. Without that follow-up activity, devices may not receive the new Kiosk until their next normal verify cycle, which can be up to **24 hours** later. There is currently no in-product warning that tells administrators they upgraded without the needed Kiosk licenses. If VPP is configured but the app has not been acquired in ASM/ABM, one useful clue is in `filewave_django.log`, which can show: - `No VPP organizations have the App Store Kiosk purchased.` ### Permissions and profile updates Because the App Store Kiosk is a **new app**, iOS/iPadOS treats it as a different application even though it serves the same purpose. Administrators should expect permission prompts such as **notifications** or **location services** to appear again after the transition. The new iOS/iPadOS Kiosk app uses this bundle identifier: - `com.filewave.ios.app.kiosk3` If you deploy a configuration profile that forces notifications or uses any other app-specific payload for Kiosk, review and update that profile for the new bundle identifier before or during the FileWave 16.3.0 transition. ### Reference: behavior in FileWave 15.3.0 through 16.2.x From **FileWave 15.3.0 through 16.2.x**, FileWave automatically deployed the newer iOS/iPadOS Kiosk through the older built-in workflow rather than the App Store / VPP model used in 16.3.0 and later. In that earlier behavior: - FileWave automatically installed the new Kiosk on managed iOS/iPadOS devices - the older App Portal web clip was removed from devices - filesets of the previous native App Portal were not automatically removed, so administrators could remove those associations if they wanted only the newer Kiosk present - newer Kiosk releases continued to be deployed automatically through that same pre-16.3.0 workflow ## Related Content - [Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+)](https://kb.filewave.com/books/kiosk/page/setting-the-primary-colour-name-and-logo-in-kioskapp-portal-160) - [Resolving SSL and Manifest Validation Errors with FileWave Kiosk Installation (15.3+)](https://kb.filewave.com/books/kiosk/page/resolving-ssl-and-manifest-validation-errors-with-filewave-kiosk-installation-153) - [Default TCP and UDP Port Usage](https://kb.filewave.com/books/filewave-general-info/page/default-tcp-and-udp-port-usage) # FileWave Kiosk Displays Company Information ## What FileWave Kiosk / App Portal can display Company Information configured in FileWave Central. Use this to give users a consistent place to find your organization name, support contact details, address, or other help desk information from macOS, Windows, iOS, and iPadOS devices. ## Where to configure it In FileWave Central, open **Preferences** and select the **Organization Info** tab. Update the organization details you want users to see in Kiosk / App Portal. [](https://kb.filewave.com/uploads/images/gallery/2024-06/Ok2VATbEZVJVfeWO-image.png) ## What users see ### macOS and Windows On macOS and Windows computers, the Company Information panel appears in the Kiosk / App Portal device information view. [](https://kb.filewave.com/uploads/images/gallery/2024-06/8GtxdbfK6j4gRr0s-image.png) ### iOS and iPadOS On iOS and iPadOS devices, the same organization details appear in the Device Information view along with enrollment and verification information. [](https://kb.filewave.com/uploads/images/gallery/2024-06/v0apx5O3MtliibEs-app-portal-comp-info.jpeg) # Kiosk Package Updates Category (macOS PKG) ### Description Kiosk may show 'Package Updates' for associated PKG Filesets where older PKGs are already installed on the device.  ### Information When a PKG Fileset is associated, as a Kiosk item, to a device, the FileWave Client will check the PKG receipts on the device. If a matching receipt is found and the version of this installation is older, the Kiosk will show this as a 'Package Update'. This is an automated category and therefore will not be visible in either: - Admin > Preferences > Kiosk > Categories - Admin > Fileset > Properties > Kiosk > Category For example, a device that already has version 1.0 of My Awesome App, installed as a PKG.  Since installation was by PKG, there should be a receipt. If you know the identifier of the PKG, you may use Terminal to confirm this: ``` # pkgutil --pkg-info com.myawesomeapp.pkg.app package-id: com.myawesomeapp.pkg.app version: 1.0 ``` Upload and create a Kiosk association of a newer PKG version of the App  When the device receives this new association, the Kiosk drop down menu will add an additional option 'Available Updates':  Clicking on this will open the Kiosk Installer window, showing the added 'Package Updates' category as shown above in the description.It does not matter how the older PKG was initially installed, e.g. through FileWave or locally. This is particularly useful for warning users, who have the option to install their own PKG and can see that an update has been offered through FileWave.
PKG version is set within the PKG by the developer of the device. If the developer does not increase the number from prior versions, then the Fileset cannot be shown as a 'Package Update'. PKG installers have their own version and this need not match the App version as shown in Finder.
# Kiosk should show only Kiosk associated Apps (15.3+) ## What Before FileWave 15.3, apps that are directly deployed to the device and have the “Allow removal” option checked are shown in Kiosk. If the user decides to remove them from their device, that app is shown in Kiosk—in case the user changes their mind and wants to have them on their device again. ## When/Why This was done before when there wasn’t Verify. Now, with Verify, this process is automated (the app will be installed again after Verify), so there is no sense in showing those apps in the Kiosk anymore. ## How In FileWave 15.3+, the Kiosk shows an item in the app list only if it is Kiosk-associated with the device. Non-kiosk-associated items do not appear on the list. This is more straightforward behavior, but it may be confusing for someone who was used to seeing apps in the Kiosk before that are now not showing. ## Related Content - [Kiosk](https://kb.filewave.com/books/kiosk "Kiosk") # Setting the Primary Colour, Name and Logo in Kiosk/App Portal (16.0+) ## What This article provides step-by-step instructions for configuring the new Kiosk2 and App Portal introduced in FileWave 16.0, including how to set a primary colour, name, and logo for the App Portal / Kiosk on FileWave v16.0+. ## When/Why For brand consistency, options exist (depending on device type) for configuring: - Colour - Name of Kiosk Window (Computers only) - Shortcut icon in macOS Menu Bar or Windows System Tray - Logo image shown in macOS/iOS/iPadOS/Windows Kiosk application ## How FileWave 16+ now offers a Policy Fileset for Kiosk customisation. Default configurations are applied when no custom Fileset is associated: - Name the Kiosk - Custom Logo, which appears in the App when launched, for all devices. (Default to FileWave Logo if no custom logo set) - Theme Colour From the Create New Fileset option, select Policy: [](https://kb.filewave.com/uploads/images/gallery/2025-02/aPTygHOM464s0kuQ-image.png) Kiosk is the newly added feature:[ ](https://kb.filewave.com/uploads/images/gallery/2025-02/HZBGEStyr01jkatH-image.png)The expected minimum image size for custom logo is: 112 x 96, 8-bit/colour RGBA, non-interlaced.
File formats accepted are: SVG, PNG, JPG.SVG, by their nature, should provide the best looking image, regardless of screen resolution: https://www.w3schools.com/graphics/svg\_intro.asp
At this time, the macOS Menu Bar or Windows System Tray Icon requires an additional Fileset. Details included below.
Note: For iOS/iPad, you will not see an entry in Fileset Status tab for the Kiosk Policy. After deployment, look under Client Info > Policies tab, and verify that the Kiosk Policy displays "true" in the Active column. If customizations do not display, force quit the Filewave Kiosk app and re-open to initiate the policy.
[](https://kb.filewave.com/uploads/images/gallery/2026-05/J7vSMURs0mIblSFt-image.png) #### Example Customisation Options Displayed in the below image: - Logo [](https://kb.filewave.com/uploads/images/gallery/2025-02/PzSG5SxfPZDfnFcQ-image.png) - Primary Colour: Green [](https://kb.filewave.com/uploads/images/gallery/2025-02/QxlGpmYo4U6ejWnH-image.png)The Menu Bar Extra Icon will show in black or white alone.
macOS may automatically hide one or more Menu Bar Extras to prevent crowding of the Menu Bar.
[FileWave Kiosk2 Menu Bar Icon.fileset.zip](https://kb.filewave.com/attachments/352) The Fileset needs to be edited prior to deployment. Out of the two files shown, the chosen custom image should be named to match the first png: 'tray-icon-macos.png'. Leave the other file in place. [](https://kb.filewave.com/uploads/images/gallery/2024-05/9RnVuVUgfWt1JLlN-image.png) Dragging the custom icon over the shown file should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/amQ1bWqAPhoSNJH6-image.png) Associate with a test device, and once happy with the look, you can broaden the association. The Fileset is designed to: - Restart the Kiosk after activation, automatically ensuring the user is immediately presented with the new logo - On de-activation, the '`tray-icon-macos.png.fw`' file will be copied to replace the custom logo (resetting the default) and again restarting the Kiosk for immediate change.Unlike the other images, the Windows System Tray is using '.ico' files. These need to be of equal size, e.g. 256x256, 128x128, etc.
Consider exporting the current 'ico' files, editing them with the chosen logo and then upload, if unsure how to create '.ico' files.
FileWave 15.4- (FileWave Client 32bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/be4WbIYnjD538Xx5-image.png) FileWave 15.5+ (FileWave Client 64bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/tkVOwySFCUUalzW9-image.png) Dragging the custom icon over the shown files should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/5YtOwr6I4T9tOVZa-image.png) Associate the relevant revision with a test device and once happy broaden the association.The new image will not show until the FileWave Client is restarted or the user logs out and back in.
If you are a [Hosted Customer](https://kb.filewave.com/books/community-engagement/page/cloud-hosting-product-information "Cloud Hosting Product Information") then you will need [Technical Support](https://kb.filewave.com/books/community-engagement/page/customer-technical-support "Customer Technical Support") to assist with these changes for now.
Direct editing of the IPA is not feasible. As such, the logo needs to be hosted from the FileWave Server. The chosen image needs to be placed in the following location: `/usr/local/filewave/django/static/kiosk2/images/` For the IPA to utilise this image, edit the the following file: `/usr/local/filewave/django/filewave/settings_custom.py` The line may be added to the bottom of the custom settings file and needs to include the FQDN of the FileWave Server, along with the named image in the format: *KIOSK\_LOGO\_URL = 'https://\[fully\_qualified\_domain\_name\]/filewave/static/kiosk2/images/\[file name\]'* For example, imagine those details are: - image.svg - demo.filewave.ch The line added will then appear as: `KIOSK_LOGO_URL = 'https://demo.filewave.ch/filewave/static/kiosk2/images/image.svg'` Supported file formats are: ``` - SVG - JPEG - PNG - GIF - Animated GIF - WebP - Animated WebP - BMP - WBMP ``` ### Customise Colour Colour may be customised by editing the same custom settings file. The colour should be presented in hex of either 6 or 8 characters. The line to add (again this may be added to the bottom of the custom settings file), should be of the format: *KIOSK\_PRIMARY\_COLOR = '\[hex colour\]'* For example: ``` KIOSK_PRIMARY_COLOR = '#e580ff' ``` or ``` KIOSK_PRIMARY_COLOR = '#FF0000CC' ```The FileWave Server Service should be restarted after modification of the custom settings python file.
| **Key Name** | **Key Value** | **Default** |
| logo\_url | URL path to hosted custom image | FileWave Logo |
| primary\_color | Colour in hex format, e.g. #RRGGBB | \#0465DA |
| kiosk\_app\_name | Text Name of opened Kiosk Window | FileWave Kiosk |
It may be necessary to reboot the computer or log out and back in, before changes take effect; particularly if customisation of the older Version 1 Kiosk was removed at the same time that the new Version 2 Kiosk and customisation is applied.
If the custom icon is added as per the instructions for i(Pad)OS devices, the same URL may be used in the above settings.
#### macOS Menu Bar Extra Icon The following method provides a pre-configured Fileset for customising this icon with a local file.The Menu Bar Extra Icon will show in black or white alone.
macOS will automatically hide one or more Menu Bar Extras to prevent crowding of the Menu Bar.
[FileWave Kiosk2 Menu Bar Icon.fileset.zip](https://kb.filewave.com/attachments/352) The Fileset needs to be edited prior to deployment. Out of the two files shown, the chosen custom image should be named to match the first png: 'tray-icon-macos.png'. Leave the other file in place. [](https://kb.filewave.com/uploads/images/gallery/2024-05/9RnVuVUgfWt1JLlN-image.png) Dragging the custom icon over the shown file should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/amQ1bWqAPhoSNJH6-image.png) Associate with a test device, and once happy with the look, you can broaden the association. The Fileset is designed to: - Restart the Kiosk after activation, automatically ensuring the user is immediately presented with the new logo - On de-activation, the '`tray-icon-macos.png.fw`' file will be copied to replace the custom logo (resetting the default) and again restarting the Kiosk for immediate change.| **Key Name** | **Key Value** | **Default** |
| logo\_url | URL path to hosted custom image | FileWave Logo |
| primary\_color | Colour in hex format, e.g. #RRGGBB | \#0465DA |
| kiosk\_app\_name | Text Name of opened Kiosk Window | FileWave Kiosk |
It may be necessary to reboot the computer before changes take effect; particularly if customisation of the older Kiosk was removed at the same time that the new Kiosk and customisation is added.
If the custom icon is added as per the instructions for i(Pad)OS devices, the same URL may be used in the above settings.
#### Windows System Tray Icon The following method provides a pre-configured Fileset for customising this icon with a local file. [FileWave Kiosk2 Sytem Tray Icon.fileset.zip](https://kb.filewave.com/attachments/427) The provided Fileset contains two revisions: - FileWave Client version 15.4- (32bit FileWave Client) - FileWave Client version 15.5+ (64bit FileWave Client) [](https://kb.filewave.com/uploads/images/gallery/2024-08/ZolzIDi5VqyuYZ1O-image.png) The Fileset needs to be edited prior to deployment. Out of the four files shown, the chosen custom icon should be named to match the two icon files: 'tray-icon-dark.ico' and 'tray-icon-light.ico'. Leave the other two files in place.Unlike the other images, the Windows System Tray is using '.ico' files. These need to be of equal size, e.g. 256x256, 128x128, etc.
Consider exporting the current 'ico' files, editing them with the chosen logo and then upload, if unsure how to create '.ico' files.
FileWave 15.4- (FileWave Client 32bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/be4WbIYnjD538Xx5-image.png) FileWave 15.5+ (FileWave Client 64bit) [](https://kb.filewave.com/uploads/images/gallery/2025-01/tkVOwySFCUUalzW9-image.png) Dragging the custom icon over the shown files should prompt a message as below. Select Replace. [](https://kb.filewave.com/uploads/images/gallery/2024-05/5YtOwr6I4T9tOVZa-image.png) Associate the relevant revision with a test device and once happy broaden the association.The new image will not show until the FileWave Client is restarted or the user logs out and back in.
This feature is an initial implementation of what a Missing Device workflow could look like. It is not complete yet, but we welcome your feedback about how to expand on this.
## When/Why Imagine the scenario in an educational institution at the end of the school year. Devices issued to students must be returned, and as the FileWave Administrator, you need to provide clear, actionable instructions. With the new “Missing Device” message, the Kiosk offers a friendly yet authoritative reminder—such as “End of Year Reminder: Please return your device to the school’s IT office”—ensuring students know exactly where and how to return their equipment. Similarly, consider a loaner laptop that is overdue for return. Marking the device as “Missing” in FileWave Admin triggers the Kiosk to display a message that not only informs the user of its missing status but also underscores the urgency of returning the laptop. In a corporate setting, a leased device approaching the end of its lease requires a seamless turnover. By marking the device as “Missing,” the Kiosk alerts the employee that the current device must be surrendered for replacement, streamlining the process and minimizing downtime. How When you mark a macOS or Windows client as “Missing” in FileWave Admin, the process is straightforward. Right-click on the device in FileWave Central, select **Client State > Missing**, and then execute a **Model Update**. Once this action is completed, the next time the user launches the FileWave Kiosk, the interface updates to display the “Missing Device” message. For example, in an educational setting, the Kiosk might display a custom message like: *“End of Year Reminder: Please return your device to the school’s IT office. This device is needed for inventory and future student use.”* This custom text is configurable in Central Admin under Organization Info, where you can also add a footnote with further instructions or a clickable contact number.It’s important to note that the “Missing Device” message is only visible when the Kiosk is opened. To ensure that users receive immediate instructions—even if they are not actively in the Kiosk—you may want to leverage the FileWave Notifications feature. With FileWave Notifications, you can send a pop-up message directly to the device. This message can include a clickable link that directs users to a webpage with detailed instructions on how to turn in the device or even a form to fill out. For more details on how to configure and send these notifications, see the [FileWave End-User Notifications](https://kb.filewave.com/books/kiosk/page/filewave-end-user-notifications-155 "FileWave End-User Notifications (15.5+)") article.
While the device remains in the “Missing” state, the Kiosk restricts all Kiosk operations—preventing user-driven installations, uninstallations, and access to self-service options—thus ensuring that the device cannot be misused until it is recovered or replaced. **Notes on "Missing Device" Message in Kiosk for macOS and Windows** - When a macOS or Windows client is marked as “Missing” in FileWave Admin, a **“Missing Device”** message will now be displayed in the Kiosk, similar to the “Device Locked” message. - The “Missing Device” message will include any custom **Lost Mode Message** and **Lost Mode Footnote** set in Central Admin under **Organization Info**. - By default, if no custom message is set, the following message appears: “This device is currently marked as missing. Self-service Kiosk is not available. Please contact your administrator.” - **Kiosk Restrictions**: While in the "Missing" state, the Kiosk will prevent installation, uninstallation, and normal access to self-service options, similar to “Device Lock” functionality. - Setting the text seen. In FileWave Central go to Preferences and then Organization Info: - If only the **Lost Mode Message** is set, it will display alone. - If only the **Lost Mode Footnote** is set, the default lost mode message will appear with the custom footnote. - If an organization contact number is set, it will be displayed as a clickable link for easy access. [](https://kb.filewave.com/uploads/images/gallery/2025-02/dJLIG2vAttPSKUQ7-image.png) [](https://kb.filewave.com/uploads/images/gallery/2025-02/5ZenF5VC3OaxrhP5-image.png) ## Related Content - [FileWave End-User Notifications (15.5+)](https://kb.filewave.com/books/kiosk/page/filewave-end-user-notifications-155 "FileWave End-User Notifications (15.5+)") # App Portal on iOS/iPadOS devices that don't support the application (15.3+) ## What If you have an iOS/iPadOS device that is older than what is officially supported by FileWave and you are working ok but you can't get the Kiosk (App Portal) to install. ## When/Why You can revert for now to the old WebClip using the documented process here. This is a temporary workaround. ## How It is possible to activate Web Clip of an old App Portal on devices which don't support new App Portal. 1. Create new Apple Profile → Web Clip Profile (can be done in both FileWave Central and Anywhere) [](https://kb.filewave.com/uploads/images/gallery/2024-03/XI9P69wTFQqUogdq-image.png) 2. Fill in URL field with: `https://fqdn:20443/ios/recommended_apps/%device_id%#apps` replacing "fqdn" with your server's DNS name. 3. Deploy profile to desired device(s). ## Related Content - [Automatic updating of iOS Kiosk (15.3+)](https://kb.filewave.com/books/kiosk/page/automatic-updating-of-iosipados-kiosk "Automatic updating of iOS Kiosk (15.3+)") # Applications Preventing Reboot (macOS/Windows) ## Description Before the FileWave client reboots a computer, where the Fileset properties are set to reboot, a warning can be expected to 'Quit All Running Processes' with a list for the user to address. Some processes do not respond to FileWave Clients requests to quit when "Quit all" or "Quit Application" is being used, because they are being immediately restarted by LaunchDaemon after quitting, or do not respond properly to the signals sent to them by FileWave. This can result in users being blocked from installing FileSets with the "Reboot" Flag set. ## Information Although this warning is usual, there are instances where certain apps or processes can appear in the queue that are unexpected, for example:  As a service, this can show even though the user is not using Adobe Apps at the time. ## Solution Requirements to prevent this experience are: - Customised Kiosk Fileset - macOS client - Bundle ID of the App or Service to exclude - Windows client - Name of running process A settings file may be configured to allow for certain apps. Create a fileset containing the settings.ini and then associate it to the desired clients. The directory where the file should be placed depends on the operating system: ##### **macOS** ``` /usr/local/sbin/FileWave.app/Contents/Resources/fwGUI.app/Contents/custom ``` ##### **Windows (FW v15.4.2 or lower)** ``` C:\Program Files (x86)\FileWave\custom ``` ##### **Windows (FW v15.5.0 or higher)** ``` C:\Program Files\FileWave\kiosk\custom ``` The changes will only be visible in the desktop Kiosk after the user logs out and logs in again. To exclude an unexpected process from being listed and preventing the reboot, first obtain the Bundle ID or process name of the listed App or Service. ### Obtain Bundle ID or Process Name #### Windows - Send any Fileset that has its Fileset Properties set to 'Requires Reboot' to the test machine - Hover over the desired process to exclude  In this example, to exclude notepad you require: 'notepad.exe' #### macOS - Change a test device's Debug Level to 99 through the [Client Monitor](https://kb.filewave.com/books/filewave-central-anywhere/page/working-with-filewave-clients "Working with FileWave Clients") - Send any Fileset that has its Fileset Properties set to 'Requires Reboot' to the test machine - Once device prompts to quit applications, open the the FWGUI.log found in the users Application Support directory. ``` ~/Library/Application\ Support/FileWave/FWGUI.log ``` There should be lines similar to the following, for each process that has prevented the reboot: ``` |DEBUG|INSTALLER|[addProcessInfo] new process added /Applications/Utilities/Terminal.app pid 67345 bundleID com.apple.Terminal |DEBUG|INSTALLER|[addProcessInfo] new process added /Applications/Preview.app pid 73400 bundleID com.apple.Preview |DEBUG|INSTALLER|[addProcessInfo] new process added /Applications/TextEdit.app pid 73718 bundleID com.apple.TextEdit ``` ### Configure 'settings.ini' The 'settings.ini' file should be configured with the following format (Bundle IDs or processes being a comma separated list): ``` [General] ignoredApplications=com.bar, com.foo ``` For the example of Windows Notepad, it should read: ``` [General] ignoredApplications=notepad.exe ```To avoid the newer default processes Microsoft now include, consider ignoring the following:
``` [General] ignoredApplications=StartMenuExperienceHost.exe,SearchApp.exe,TextInputHost.exe ``` For the example of macOS TextEdit, it should read: ``` [General] ignoredApplications=com.apple.TextEdit ``` Combining this with current generic settings, it may look something like: ``` show_top_downloads=false window_title="My Customized Kiosk" hide_system_tray=false [General] ignoredApplications=com.adobe.acc.AdobeDesktopService,com.apple.TextEdit ``` ### Deployment Deploy the 'settings.ini' file to the following locations: #### **macOS** ``` /usr/local/sbin/FileWave.app/Contents/Resources/fwGUI.app/Contents/custom ``` #### **Windows (FW 15.4.2 and lower)** ``` C:\Program Files (x86)\FileWave\custom ``` #### **Windows (FW 15.5.0 and higher)** ``` C:\Program Files\FileWave\kiosk\custom ``` # Manual Trigger of FileWave Kiosk for macOS and Windows (15.3+) ## What By default, the Kiosk icon is only shown when one or more assignments between Filesets and Devices are created; set as Kiosk installation. It may be desirable to view the Kiosk even where Kiosk assignments do not exist, since the Kiosk also shows other details, which may be useful to the user, e.g. device information. [](https://kb.filewave.com/uploads/images/gallery/2025-01/9gvMU2ootVgCDuhh-image.png) [](https://kb.filewave.com/uploads/images/gallery/2025-01/hO8ONX4jRgbLpBwl-image.png) The following provides information for triggering the Kiosk manually. ## When Prior to Kiosk v2, it was possible to provide a custom file to show the Kiosk icon, regardless of assignments. Currently Kiosk v2 has no similar option. ## How For both macOS and Windows, the executable file may be targeted directly from a shell: macOS (shell): ``` /usr/local/sbin/FileWave.app/Contents/MacOS/FileWave\ Kiosk.app/Contents/MacOS/FileWave\ Kiosk ``` Windows (PowerShell): ``` & "C:\Program Files\FileWave\client\kiosk\FileWaveKiosk.exe" ``` ### GUI As a script line, this isn't the most user friendly method for users to execute and of course the obvious place to have something for users to self trigger would be in the FileWave Kiosk, but clearly that is nonsensical. There are alternatives though. #### macOS There is already a KB on integration of the amazing 3rd party tool: 'Hello-IT' - [Hello-IT](https://kb.filewave.com/books/integrations/page/hello-it-integration-with-filewave-macos) Through this tool, it could be possible to provide users with another method to open the Kiosk, where Kiosk assignments do not exist: [](https://kb.filewave.com/uploads/images/gallery/2025-01/HbvvSjHf5X7XKczC-image.png) By following the provided guide on Hello-IT, the small one-liner script could be added as one of the sub menu items. When clicked, FileWave Kiosk would launch. #### Windows A similar trick could be used on Windows with another amazing 3rd party tool: 'About My Device' - [About My Device Instructions](https://www.systanddeploy.com/2021/03/about-my-device-systray-tool-for-that.html) - [About My Device Repo](https://github.com/damienvanrobaeys/About_my_device) Although it doesn't immediately offer the option to add scripts in the way Hello-IT does, it can be hijacked to do so. One of the features is an option to trigger a script to provide logs: [](https://kb.filewave.com/uploads/images/gallery/2025-01/hOVwlKFxTclvHLzw-image.png) However, by editing the configuration and script files, this could be renamed and the script altered to include the PowerShell one-liner from above: AboutMyDevice\_Systray.ps1 [](https://kb.filewave.com/uploads/images/gallery/2025-01/8yyBpsVEXBxfs8a6-image.png) Collect\_Logs.ps1 [](https://kb.filewave.com/uploads/images/gallery/2025-01/8bDx3TqB7I3lIayN-image.png) Example [](https://kb.filewave.com/uploads/images/gallery/2025-01/97CwD6tOyl39rAoG-image.png) Of course, it might be desirable to keep the option to send logs, so choose the best method for adaption to suit requirements. Additionally, there may be other 3rd party tools that could be of consideration. Do please let other FileWavers know if other tools could be considered as appropriate or better. # FileWave End-User Notifications # FileWave End-User Notifications (15.5+) ## What With the release of FileWave version **15.5.0** and onward, administrators can now send custom messages to enrolled devices directly from FileWave Anywhere, FileWave Central, or through API calls. These messages appear as system notifications on users’ devices, allowing administrators to communicate important information efficiently and effectively, thereby enhancing user engagement and experience. #### Key Functionality - **User-Friendly Interface**: Administrators can easily send notifications by selecting one or multiple devices or groups and accessing the **“Send Notification”** action. - **Customizable Content**: Personalize notifications with a title, author, message content, and optional links to provide context and additional resources. - **Expiration Date**: Set an expiration date and time for notifications to ensure they are timely and relevant. - **Platform Compatibility**: Notifications are supported across multiple platforms, including macOS, Windows, iOS, iPadOS, ChromeOS, and Android devices. - **Client Compatibility**: This feature requires devices to have the FileWave Client version **15.5.0** or newer installed. - **Audit History**: Sent notifications are recorded and can be reviewed in the Audit History for compliance and tracking purposes. - **Validation and Error Handling**: The system ensures that all mandatory fields are filled out and provides clear error messages if issues arise, such as invalid input or unsupported devices.Send Notification requires Permissions granted within the Managed Administrator view. 'fwadmin' account will automatically be granted such permissions, but other accounts or groups should be enabled as desired.
## When/Why #### When to Use - **Urgent Announcements**: Quickly inform users about critical updates, security alerts, or system maintenance. - **Company Communications**: Share company news, policy changes, or reminders directly to users’ devices. - **Event Notifications**: Notify users about upcoming events, meetings, or deadlines. - **Support and Guidance**: Provide users with immediate assistance or instructions when issues are detected. #### Why Use This Feature - **Direct Communication**: Bypass email clutter and ensure important messages are seen by delivering them straight to the user’s device. - **Improved Engagement**: Enhance user experience by keeping users informed and engaged with timely notifications. - **Cross-Platform Support**: Reach users regardless of the device or platform they are using. - **Efficient Administration**: Streamline the process of sending notifications to multiple devices or groups simultaneously. ## How #### Sending a Notification 1. In FileWave Central right click on a Client, Group or Smart Group and pick **Send Notification...** 2. Ensure that all of the options are set how you want. **Author:** Your name **Title:** The title of the notification dialog **Text:** The detailed text to display **Add Link:** This allows you to have a clickable link on the notification **Expiration date:** After this date and time the system will not continue to try to get the notification to the selected devices. [](https://kb.filewave.com/uploads/images/gallery/2024-10/4RRZZZUGUkSrI86L-image.png) 3. A confirmation dialog will ask you to confirm sending and tell you the number of devices being messaged. Check that the number reflects what you think it should be. If it says 500 but you meant to message 5 devices then click **Back** and then **Cancel** if you want to try to pick devices again. Once you click the final **Send** button on the confirmation dialog there is no canceling it.If you selected a Group or Smart Group it is important to know that the targets will be the devices that were in that group at the time you sent the message. If a device enters the group tomorrow it will not get the message even if the message has not expired yet. Similarly if a device leaves the group after you already sent the message it will still receive the message when it comes online.
#### User Experience - **System Notification**: Users will receive the notification as a system alert on their devices. - **Notification Details**: Clicking on the notification will display the full message and any included links. - **Confirmation Dialog**: After sending, administrators receive a confirmation dialog confirming the notification was successfully sent. - **Timing of notification:** It will display as soon as the device either gets an OS driven notification which should be within a few minutes of it coming online. #### Examples of what is seen by users| **iPadOS / iOS** | [](https://kb.filewave.com/uploads/images/gallery/2024-12/aKhtelgYi3qf0FE2-image.png) |
| **macOS** | [](https://kb.filewave.com/uploads/images/gallery/2024-12/0ySLh9BOeP7oqDBn-image.png) |
| **Android** | [](https://kb.filewave.com/uploads/images/gallery/2024-12/YjMrMw6I5EROcUZ8-image.png) |
| **Windows** | [](https://kb.filewave.com/uploads/images/gallery/2024-12/78LnXOeejkPpUVem-image.png) |
| **ChromeOS** | [](https://kb.filewave.com/uploads/images/gallery/2024-12/8qWSTdOB5fwaubpQ-image.png) |
FileWave Central will show the local timezone of the computer running FileWave Central. FileWave Server will convert the set time as UTC instead and expire the notification at that UTC time.
##### Platform-Specific Behaviors - **iOS/iPadOS**: - **Delivery to Active Users**: Notifications are only delivered to the user currently logged in on the device on Shared iPad. 1:1 users can receive notifications at Lock Screen. - **Session-Specific**: Notifications received by one user are not visible to other users who log in later. - **Expiration Handling**: If a notification is valid on Apple’s servers but expired on the device, it will display, but clicking it will only open the App Portal without showing the full message. - **macOS**: - **Logged-Out Users**: Users who are logged out will not receive notifications sent during their absence. - **Multiple Users**: All users on a device will receive the notification individually. - **Unread Notifications**: Unread, valid notifications will reappear in the Notification Center if it is cleared or the device restarts, after a new notification arrives. - **Expiration Cleanup**: After the expiration time, macOS may take up to an hour to remove the notification from the Notification Center. - **Kiosk Visibility**: If the Kiosk is not normally visible, it will temporarily appear when displaying notification details and will be removed once closed. - **Enabling Notifications**: Administrators can enforce notifications using an [Apple Profile](https://kb.filewave.com/books/kiosk/page/force-enable-notifications-on-ios-and-macos-for-filewave-kiosk "Force Notifications on macOS for FileWave Kiosk"), preventing users from disabling them. - **Windows**: - **Multiple Users**: Similar to macOS, all users on a device will receive the notification. - **Notification Persistence**: Unread notifications will reappear after the Notification Center is cleared or the device restarts, as long as they are still valid. - **Kiosk Visibility**: The Kiosk app behaves the same as on macOS regarding temporary visibility. - **ChromeOS**: - **User Limitations**: If one user reads a notification, it becomes unavailable to other users on the same device due to ``` 2026-01-02 15:42:08.820 [P:60]Example Filesets that you might have used to push out these settings: Windows (64) - [Kiosk\_Customizer\_for\_Windows64.fileset.zip](https://kb.filewave.com/attachments/13) Windows (32) - [Kiosk\_Customizer\_for\_Windows32.fileset.zip](https://kb.filewave.com/attachments/14) macOS - [Kiosk\_Customizer\_for\_macOS.fileset.zip](https://kb.filewave.com/attachments/15) macOS/Windows - [Applications Preventing Reboot](https://kb.filewave.com/books/kiosk/page/applications-preventing-reboot-macoswindows "Applications Preventing Reboot (macOS/Windows)")
# Customizable icons You might have included icon files that you used to replace them in Kiosk before 15.3. These icons will not appear in 15.3 or newer.| File name | Description | Example | Pixel Size |
| action\_back.png | Icon for the "Back" action in the Software Installation dialog |  | 48x48 |
| action\_forward.png | Icon for the "Forward" action in the Software Installation dialog |  | 48x48 |
| background\_icon.png | Icon used for the watermark | (FileWave icon) | 512x512 |
| rating\_star\_half.png | Icon for half a rating star |  | 40x40 |
| rating\_star\_off.png | Icon for a rating star that is off |  | 40x40 |
| rating\_star\_on.png | Icon for a rating star that is on |  | 40x40 |
| tray\_icon.png | System tray icon. If missing, the background\_icon.png is used. | (FileWave icon) | 16x16 |
| warning.png | Warning icon, displayed when a fileset has problems (e.g. missing VPP user) |  | 64x64 |
Use cautiously
Without the necessary configuration, the new Kiosk will not show and the user logs will show something like: ``` 2024-05-13 10:40:15.324 FileWave Kiosk[1241:5674] Could not acquire Metal device. 2024-05-13 10:40:25.936 FileWave Kiosk[1241:5674] Unable to create FlutterView; no MTLDevice or MTLCommandQueue available. ``` ## Configuration The following configuration requires the VM to be shutdown (not paused) prior to editing. Locate the containing folder of the VM. Within this will be a .vmx file. For example, if the containing VM Folder were called 'macOS 12.vmware, the file to edit should be called 'macOS 12.vmx': ``` /Users/sholden/Documents/Virtual\ Machines/macOS\ 12.vmwarevm/macOS\ 12.vmx ``` Add the following two lines: ``` appleGPU0.present = "TRUE" svga.present = "FALSE" ``` Once added, the VM may then be booted. To remove this configuration, again shutdown the VM, edit the file, this time removing these two entries. It may also be necessary to define the aspect ratio in the same file with the following two lines. 1920 x 1080 used as an example: ``` appleGPU0.screenWidth="1920" appleGPU0.screenHeight="1080" ```Although this may work, in practice the VM crashed too often or became seemingly unusable. Since the host may also Kernel Panic, recommendation would be to avoid configuring this on VMware test devices, unless absolutely necessary. Even then, consider undoing this once the test has been completed.
# Resolving SSL and Manifest Validation Errors with FileWave Kiosk Installation (15.3+) # What This article addresses an issue encountered during the installation of the new FileWave Kiosk v.15.3.1 on macOS and Windows devices. Users may encounter SSL errors and manifest validation failures that prevent the Kiosk from installing correctly. # When/Why These installation errors typically occur when upgrading to FileWave v.15.3.1 and are primarily due to conflicts with certain content filters or proxy settings that block or misclassify necessary URLs. This is particularly relevant for organizations using content filtering solutions like Lightspeed, which may categorize essential URLs as unknown, thus blocking them. ``` "InstallApplication command error 2024-04-22T07:36:38 2024-04-22T07:36:38 Could not validate manifest..An SSL error has occurred and a secure connection to the server cannot be made. com.filewave.ios.app.kiosk2 " ``` # How To resolve these installation issues, follow the steps below: 1. **Check Proxy and Firewall Settings**: Ensure that your organization's proxy or firewall settings are not blocking access to FileWave URLs. 2. **Whitelist Necessary URLs**: Add the following URLs to the whitelist in your content filter or proxy settings: - `https://fw-kiosk-v2-ipas.filewave.cloud/` - `*.filewave.cloud` This change allows devices to communicate securely with FileWave servers and access the necessary resources for installing the Kiosk. 3. **Reattempt Installation**: After updating your settings, reattempt the installation of the FileWave Kiosk on the affected devices. ```shell # Example command to verify if the URL is accessible from your network curl -Iv https://fw-kiosk-v2-ipas.filewave.cloud/ ``` If the issue persists, check your SSL certificate settings and network configuration for any discrepancies that might be interfering with secure connections. # Related Links - [Default TCP and UDP Port Usage](https://kb.filewave.com/books/filewave-general-info/page/default-tcp-and-udp-port-usage "Default TCP and UDP Port Usage") # Digging Deeper The SSL error typically indicates an underlying issue with the secure connection setup between the client device and FileWave servers. This can be caused by SSL certificate verification failures, misconfigured proxies, or stringent network security policies that incorrectly classify or block legitimate URLs required for FileWave operations. Adjusting content filtering policies or proxy settings often resolves these issues, but further investigation into SSL trust settings may be required for complex network environments.