Installing the Workstation Client

Last modified: July 3, 2026

Introduction

After creating one or more workspaces for your organization, you can proceed by installing the Workstation Client on the computers which you want to register as stations in Workstation Management.

Prerequisites

Before you install the Workstation Client, ensure that you fulfill the following prerequisites.

System Requirements

  • Operating System - Windows 10 or Windows 11 (64-bit); Linux ARM64; macOS (Apple Silicon)
  • Memory - Minimum 4 GB RAM (8 GB recommended for optimal performance)
  • Disk Space - 400 MB of free disk space for installation

Access Requirements

You must have a Mendix account with owner or admin access to Mendix Workstation Management.

Downloading the Client

You can download the Client from the Mendix Marketplace at the following links:

Alternatively, you can download the global Microsoft Windows version of the Client directly from Workstation Management by performing the following steps:

  1. Open the station that you created and click Register Computer.

  2. In the Computer Registration dialog, click Download.

This opens the Mendix Marketplace page for the global Microsoft Windows version of the installer. If you want to install the portable, Linux or macOS version, use the Marketplace search, or navigate to them through the above links.

Installing the Workstation Client

Refer to the following topics for information about installing the Workstation Client.

Windows (Global)

If you have administrator rights for your Windows computer, install the Workstation Client by performing the following steps:

  1. Download the global Microsoft Windows version of the installer.

  2. Run the Workstation Client installer.

  3. If you get a prompt from Windows User Account Control, click Yes to allow Workstation Client to be installed.

    For a silent installation, you can also run the installer as an administrator with the /S argument, that is, MendixWorkstationX.Y.Z.exe /S.

The default installation folder is C:\Program Files\Mendix Workstation. The app data folder can be found at C:\ProgramData\Mendix Workstation. The client runs automatically after the installation is completed.

Windows Portable

If you do not have administrator rights for your Windows computer, create a portable instance of the Workstation Client by performing the following steps:

  1. Download the portable Microsoft Windows version of the installer.
  2. As a best practice, create a new folder for the Client (for example, in your Documents folder).
  3. Extract the Client to the target folder, and then click the .exe file to run the Client.

Linux

To install the Workstation Client on a Linux machine, perform the following steps:

  1. Download the Linux version of the installer.

  2. Install the Client by running the following command, where X.X.X.X is the version and build number of the downloaded .deb package:

    sudo apt install ./MendixWorkstation_X.X.X.X_arm64.deb

  3. Install the card reader dependencies by running the following command:

    sudo apt install pcscd libcap2-bin

  4. Enable card reader dependencies by running the following command:

    sudo systemctl enable pcscd --now

  5. To start the application, go to the Applications menu > Accessories > Mendix Workstation.

    Bluetooth support requires starting the application with the CAP_NET_RAW privilege (for raw network packet access):

    sudo capsh --user=$(whoami) --iab="^cap_net_raw" -- -c "'/opt/Mendix Workstation/Mendix Workstation'"

The Workstation Client runs automatically at system startup. To modify this behavior, see Stopping the Workstation Client.

Stopping the Workstation Client

The Close button closes the Client window but does not terminate the application; it continues to run in the background. To completely quit the Client, right-click its icon in the Windows systray and select Quit. This action is only available if Developer Mode is enabled. Alternatively, the Workstation Client process can always be stopped via Windows Task Manager.