Overview

This article explains how to install the 3CX Web Client as a Progressive Web App (PWA) on a user's workstation. Installing as a PWA gives the web client a native app look and feel — including its own window, taskbar icon, and optional auto-start behavior — without requiring a full desktop application installation. Technicians should follow this guide when onboarding users who will access 3CX through a browser-based client.

Prerequisites

  • Access to the 3CX Web Client URL for the client's 3CX instance
  • Google Chrome or Microsoft Edge installed on the user's workstation (PWA installation is supported in both browsers)
  • User must be logged into the 3CX Web Client prior to installing the PWA

Steps

  1. Open the 3CX Web Client
    Navigate to the client's 3CX Web Client URL in Google Chrome or Microsoft Edge and log in with the user's credentials.
  2. Access the Client Installation Dialog
    If no client has been installed yet, click the OS icon displayed below the user avatar in the 3CX interface. A dialog box will appear with available client options.

  3. Select the Web App (PWA) Option
    In the dialog, select Web App (PWA) and then click the Install button to proceed with the PWA installation.
  4. Alternative: Install Directly from the Browser Address Bar
    If the dialog is not available, look for the Install button in the browser's address bar — this icon appears as a screen with an arrow (circled in red in the screenshot below). Click it and confirm the installation prompt.

  5. Configure Auto-Start (Optional but Recommended)
    To ensure 3CX launches automatically when the user signs into Windows, configure auto-start based on the browser being used:
    • Google Chrome: Open Chrome and navigate to chrome://apps in the address bar. Right-click on the 3CX app and select Start app when you sign in.
    • Microsoft Edge: During the installation dialog that appears after completing the PWA install, select the option to Auto-start the app on sign-in.

Notes & Tips

  • The PWA option is recommended for users who prefer not to install the full 3CX desktop application, as it provides a comparable experience with minimal setup.
  • The PWA must be installed per user and per browser — it is not a system-wide installation.
  • If the install icon does not appear in the address bar, ensure the browser is up to date, as older versions may not support PWA installation prompts.
  • Users on Microsoft Edge may see additional PWA management options under Settings > Apps within the browser.

References