This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Install the SamurAI Portal as an App (PWA)

    The SamurAI Portal can be installed as a Progressive Web App (PWA) on supported mobile and desktop browsers. Once installed, it opens in an app-style window and can send push notifications for enabled portal events when your browser, operating system, and SamurAI notification settings allow it.

    What is a PWA?

    A Progressive Web App (PWA) is a secure web application that can be installed on your device and launched like an app. Depending on your browser and operating system, a PWA can appear on your home screen, desktop, or dock and can support notifications.

    Why install the SamurAI Portal?

    Installing the SamurAI Portal as a PWA gives you quicker access and a cleaner experience without needing an app store.

    • Faster access from your home screen, desktop, or dock
    • A cleaner app-style window with less browser clutter
    • Push notifications for enabled events on supported platforms
    • A consistent experience across supported mobile and desktop devices

    Before you begin

    Make sure you have:

    • A supported browser and device
    • An up-to-date operating system
    • Permission to allow notifications in your browser
    • Notifications enabled in your SamurAI profile and for the event categories you want to receive

    Supported platforms

    • iPhone and iPad: Safari on iOS or iPadOS 16.4 or later
    • Android: Chrome or another supported Chromium-based browser
    • Windows: Google Chrome or Microsoft Edge
    • macOS: Safari on macOS 13 or later

    Install the SamurAI Portal

    iPhone and iPad

    1. Open the SamurAI Portal in Safari
    2. Tap Share
    3. Select Add to Home Screen
    4. Open the SamurAI Portal from the new Home Screen icon
    5. Allow notifications when prompted
    6. Confirm notifications are enabled for the app in Settings > Notifications

    Android

    1. Open the SamurAI Portal in Chrome or another supported browser
    2. Use the browser menu and select Install app or Add to Home screen
    3. Open the installed app
    4. Allow notifications when prompted
    5. Confirm notifications are enabled in your Android app settings

    Windows

    1. Open the SamurAI Portal in Google Chrome or Microsoft Edge
    2. Install the app from the browser address bar or browser menu
    3. Open the installed app
    4. Allow notifications when prompted
    5. Confirm notifications are enabled in Settings > System > Notifications

    macOS

    1. Open the SamurAI Portal in Safari
    2. Select File > Add to Dock
    3. Open the SamurAI Portal from the Dock
    4. Allow notifications when prompted
    5. Confirm notifications are enabled in System Settings > Notifications

    Enable SamurAI notifications

    Refer to Notification Settings for user configurable push and email notifications.

    Troubleshooting

    If you are not receiving push notifications:

    1. Confirm the SamurAI Portal is installed as an app on your device
    2. Confirm Push Notifications are enabled in your SamurAI profile settings
    3. Confirm notifications are enabled for the required event categories
    4. Check that browser notification permission is set to Allow
    5. Check that operating system notifications are enabled for the installed app or browser
    6. Turn off Do Not Disturb or Focus modes, or allow SamurAI notifications through them
    7. Update your browser and operating system to the latest available version

    If the issue continues, capture the following before raising a ticket:

    • Device type
    • Operating system and version
    • Browser and version
    • Whether the portal is installed as an app
    • Screenshots of browser and operating system notification permissions

    You can then raise a ticket in the SamurAI Portal.

    Notes and limitations

    • Push notifications depend on browser support, operating system support, user permissions, and your SamurAI notification settings
    • Installation steps and install prompts can vary slightly by browser and platform
    • Corporate browser policies, device management policies, or security settings may block installation or notifications
    • If your organization restricts browser notifications, contact your IT administrator
    • An internet connection is required to use the SamurAI Portal