From 756acb3ede0936411fe06cee7dd07ffb983de166 Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Fri, 23 Jan 2026 14:00:29 +0100 Subject: [PATCH 1/5] Registering workstation clients --- content/en/docs/workstation/wks-batch-registration.md | 9 +++++++++ 1 file changed, 9 insertions(+) create mode 100644 content/en/docs/workstation/wks-batch-registration.md diff --git a/content/en/docs/workstation/wks-batch-registration.md b/content/en/docs/workstation/wks-batch-registration.md new file mode 100644 index 00000000000..95fb6af8a58 --- /dev/null +++ b/content/en/docs/workstation/wks-batch-registration.md @@ -0,0 +1,9 @@ +title: "Registering Workstation Clients" +url: /mendix-workstation/register/ +description: "Describes how to register and pre-configurer multiple Workstation Clients." +weight: 30 +--- + +## Introduction + +You can register multiple workstation clients and their host computers in a single rollout. This enables large-scale deployments on production floors (e.g., factory shop floors) where dozens to hundreds of machines require setup. The existing single-computer registration remains available for development and testing. The system now remembers previously registered computers and supports pre-configuration of computer names so future registrations apply the correct mappings automatically. \ No newline at end of file From 6bb4733feaeeaea6ac9e9f4da3576938175fbaa4 Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Tue, 3 Feb 2026 21:27:23 +0100 Subject: [PATCH 2/5] updates --- content/en/docs/workstation/wks-batch-registration.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/content/en/docs/workstation/wks-batch-registration.md b/content/en/docs/workstation/wks-batch-registration.md index 95fb6af8a58..25ccc24edaa 100644 --- a/content/en/docs/workstation/wks-batch-registration.md +++ b/content/en/docs/workstation/wks-batch-registration.md @@ -6,4 +6,5 @@ weight: 30 ## Introduction -You can register multiple workstation clients and their host computers in a single rollout. This enables large-scale deployments on production floors (e.g., factory shop floors) where dozens to hundreds of machines require setup. The existing single-computer registration remains available for development and testing. The system now remembers previously registered computers and supports pre-configuration of computer names so future registrations apply the correct mappings automatically. \ No newline at end of file +You can register multiple workstation clients and their host computers in a single rollout. This enables large-scale deployments on production floors (for example, factory shop floors) where dozens to hundreds of machines require setup. + From 90c86e0233d4871636821234c70cf1c18080bfc4 Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Fri, 6 Feb 2026 11:29:25 +0100 Subject: [PATCH 3/5] Workstation register client updates --- .../workstation/wks-batch-registration.md | 53 ++++++++++++++++++- content/en/docs/workstation/wks-build-app.md | 12 +---- 2 files changed, 53 insertions(+), 12 deletions(-) diff --git a/content/en/docs/workstation/wks-batch-registration.md b/content/en/docs/workstation/wks-batch-registration.md index 25ccc24edaa..c8091ef74ee 100644 --- a/content/en/docs/workstation/wks-batch-registration.md +++ b/content/en/docs/workstation/wks-batch-registration.md @@ -1,3 +1,4 @@ +--- title: "Registering Workstation Clients" url: /mendix-workstation/register/ description: "Describes how to register and pre-configurer multiple Workstation Clients." @@ -6,5 +7,55 @@ weight: 30 ## Introduction -You can register multiple workstation clients and their host computers in a single rollout. This enables large-scale deployments on production floors (for example, factory shop floors) where dozens to hundreds of machines require setup. +Installed on each local workstation, the Workstation Client acts as a bridge between the Mendix app and local hardware. The Workstation Client is installed on a computer in order to establish a connection with the Workstation Connector, and through it, your Mendix app. + +Mendix Workstation supports both individual registration of local Workstation clients, and bulk rollouts for large production environments. + +## Registering a Single Workstation Client + +If you are developing or testing Workstation configurations, you can register a single Workstation Client for your local computer by performing the following steps: + +1. Navigate to the **Workspaces** page in [Workstation Management](https://workstation.home.mendix.com/). +2. Click **Create Workspace**, or select an existing workspace from the overview. +3. Click **Create Station**. +4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. +5. Add devices in the **Devices** section. +6. Click **Register Computer** to register your computer. +7. Click **Download** to navigate to the Workstation Client listing in the Marketplace, download the Client installer for Windows, install it, and launch it. +8. Copy the registration token and paste it into the [Workstation Client](/mendix-workstation/installation/) registration field. + +## Bulk-Registering Workstation Clients + +In a production environment, you can register multiple Workstation clients and their host computers in a single rollout. This enables large-scale deployments on production floors (for example, factory shop floors) where dozens to hundreds of machines require setup. + +{{% alert color="info" %}} +This feature is only available to licensed Mendix Workstation users. For more information about obtaining a Workstation license, see [Mendix Workstation](/mendix-workstation/). +{{% /alert %}} + +To bulk-register Workstation Clients, perform the following steps: + +1. Open the [Workspaces](https://workstation.home.mendix.com/) page. +2. Click the workspace where you want to register the clients. +3. On the **Stations** page, click the three-dot menu in the top right corner of the screen, and then click **Bulk Register**. + + The **Create Bulk Registration Token** dialog opens. You can use it to activate a time-limited token which can then be entered into the registration field of multiple Workstation Clients. + +4. Specify the timeframe during which the token is valid. +5. Copy the token to a clipboard and save it in a secure location. For security reasons, the token is only displayed once. +6. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. +7. Use an automated script to distribute the token to client computers during the allowed timeframe. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` + + After the command runs, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station. On the **Stations** page in Workstation Management, you can now see placeholder stations also named **Waiting for station assignment**. These stations correspond to computers which were registered during bulk import. + +8. On the **Stations** page, click **View** by a placeholder **Waiting for station assignment** station. +9. Review the configuration and click **Assign to station** to reassign the computer to an existing station, or **Accept** to create a new station. + +### Automatically Assigning Computers to Stations + +Instead of reassigning computers to stations manually after the bulk import, you can configure stations to automatically accept computers with a specific name. + +1. On the **Stations** page, click the three-dot menu by the station where you want to automatically register a computer. +2. Click **Edit Station**. +3. In the **Auto-Accepted Computer Name** field, enter a computer name. +Computers with this name are automatically assigned to the station during the bulk import. \ No newline at end of file diff --git a/content/en/docs/workstation/wks-build-app.md b/content/en/docs/workstation/wks-build-app.md index 2026549a5c0..8b4523438b4 100644 --- a/content/en/docs/workstation/wks-build-app.md +++ b/content/en/docs/workstation/wks-build-app.md @@ -31,17 +31,7 @@ To install and configure the Workstation Connector, perform the following steps: 1. Open an existing app to extend with Workstation functionality in Mendix Studio Pro, or create a new app. 2. Import the [Mendix Workstation Connector](https://marketplace.mendix.com/link/component/247460) from the Mendix Marketplace. -3. Configure the station in Workstation Management by performing the following steps: - - 1. Navigate to the **Workspaces** page in [Workstation Management](https://workstation.home.mendix.com/). - 2. Click **Create Workspace**, or select an existing workspace from the overview. - 3. Click **Create Station**. - 4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. - 5. Add devices in the **Devices** section. - 6. Click **Register Computer** to register your computer. - 7. Click **Download** to navigate to the Workstation Client listing in the Marketplace, download the Client installer for Windows, install it, and launch it. - 8. Copy the registration token and paste it into the [Workstation Client](/mendix-workstation/installation/) registration field. - +3. Register one or more Workstation Clients. For more information, see [Registering Workstation Clients](/mendix-workstation/register/). 4. Configure your app as an allowed app by performing the following steps: 1. In your app go to [App Security](/refguide/app-security/#user-roles) and assign the module role **StationConnector.Administrator** to the Administrator user role. From 3d3928e820e10c2d195776d6b489ac2fd58cf7c6 Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Fri, 20 Feb 2026 12:58:29 +0100 Subject: [PATCH 4/5] SME review --- .../workstation/wks-batch-registration.md | 41 +++++++++++++------ 1 file changed, 28 insertions(+), 13 deletions(-) diff --git a/content/en/docs/workstation/wks-batch-registration.md b/content/en/docs/workstation/wks-batch-registration.md index c8091ef74ee..61d6f1495e1 100644 --- a/content/en/docs/workstation/wks-batch-registration.md +++ b/content/en/docs/workstation/wks-batch-registration.md @@ -7,7 +7,9 @@ weight: 30 ## Introduction -Installed on each local workstation, the Workstation Client acts as a bridge between the Mendix app and local hardware. The Workstation Client is installed on a computer in order to establish a connection with the Workstation Connector, and through it, your Mendix app. +Installed on each local workstation, the Mendix Workstation Client acts as a bridge between the Mendix app and local hardware. The goal of the Workstation Client is to establish a secure and reliable connection between the Mendix Application Client and the hardware, peripherals, or local data sources attached to that workstation. This connection is facilitated by the Workstation Connector and the Workstation Client. + +The registration process is a necessary first step when enabling this crucial functionality. It onboards your local Workstation Client installation into your Mendix Workstation Management environment. This onboarding allows for centralized management, configuration deployment, and monitoring of your clients, ensuring they are properly set up to bridge your Mendix applications with the physical world. Mendix Workstation supports both individual registration of local Workstation clients, and bulk rollouts for large production environments. @@ -17,12 +19,16 @@ If you are developing or testing Workstation configurations, you can register a 1. Navigate to the **Workspaces** page in [Workstation Management](https://workstation.home.mendix.com/). 2. Click **Create Workspace**, or select an existing workspace from the overview. -3. Click **Create Station**. -4. Enter a name for the station and optionally select or create a group to categorize it, such as *Assembly*. -5. Add devices in the **Devices** section. -6. Click **Register Computer** to register your computer. -7. Click **Download** to navigate to the Workstation Client listing in the Marketplace, download the Client installer for Windows, install it, and launch it. -8. Copy the registration token and paste it into the [Workstation Client](/mendix-workstation/installation/) registration field. +3. Click **Create Station**, or select an existing station for which no computer is yet registered. +4. In the top right corner of the banner, click **Register Computer** to register your computer. +5. Click **Download** to navigate to the Workstation Client listing in the Marketplace, download the Client installer for Windows, install it, and launch it. You can find the listing at the following links: + + * [Windows](https://marketplace.mendix.com/link/component/247448) + * [Windows (portable version)](https://marketplace.mendix.com/link/component/247456) + * [Linux ARM64](https://marketplace.mendix.com/link/component/247459) + * [MacOS](https://marketplace.mendix.com/link/component/253905) + +6. Copy the registration token and paste it into the [Workstation Client](/mendix-workstation/installation/) registration field. ## Bulk-Registering Workstation Clients @@ -41,14 +47,18 @@ To bulk-register Workstation Clients, perform the following steps: The **Create Bulk Registration Token** dialog opens. You can use it to activate a time-limited token which can then be entered into the registration field of multiple Workstation Clients. 4. Specify the timeframe during which the token is valid. -5. Copy the token to a clipboard and save it in a secure location. For security reasons, the token is only displayed once. -6. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. -7. Use an automated script to distribute the token to client computers during the allowed timeframe. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` +5. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. +6. To distribute the token to client computers during the allowed timeframe, you can use an automated script. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` + + After the command runs or the token is entered manually, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station. + + To view these newly registered clients, refresh the Stations page in Workstation Management. You will find them listed under a separate section as **unassigned computers**. - After the command runs, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station. On the **Stations** page in Workstation Management, you can now see placeholder stations also named **Waiting for station assignment**. These stations correspond to computers which were registered during bulk import. +7. Review the configuration of the unassigned computers and perform one of the following actions: -8. On the **Stations** page, click **View** by a placeholder **Waiting for station assignment** station. -9. Review the configuration and click **Assign to station** to reassign the computer to an existing station, or **Accept** to create a new station. + * **Accept Computer** - Create an empty station. + * **Assign Computer** - Assign the computer to an already configured station. + * **Reject Computer** - Disconnect and deregister the computer. ### Automatically Assigning Computers to Stations @@ -58,4 +68,9 @@ Instead of reassigning computers to stations manually after the bulk import, you 2. Click **Edit Station**. 3. In the **Auto-Accepted Computer Name** field, enter a computer name. +{{% alert color="info" %}} +You can also specify this name during station creation. +{{% /alert %}} + + Computers with this name are automatically assigned to the station during the bulk import. \ No newline at end of file From 931d5bc41ed0a5351158e758612a1bd696b80e1b Mon Sep 17 00:00:00 2001 From: katarzyna_koltun Date: Fri, 20 Feb 2026 14:51:39 +0100 Subject: [PATCH 5/5] Added script for Linux, changed for Windows --- content/en/docs/workstation/wks-batch-registration.md | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/content/en/docs/workstation/wks-batch-registration.md b/content/en/docs/workstation/wks-batch-registration.md index 61d6f1495e1..d81cf945da6 100644 --- a/content/en/docs/workstation/wks-batch-registration.md +++ b/content/en/docs/workstation/wks-batch-registration.md @@ -48,7 +48,11 @@ To bulk-register Workstation Clients, perform the following steps: 4. Specify the timeframe during which the token is valid. 5. Click **Activate Token**. The **Stations** page displays the timeframe during which the bulk registration is scheduled. -6. To distribute the token to client computers during the allowed timeframe, you can use an automated script. For example, on Windows machines, you can use the following script: `Start-Process -FilePath {path where the Workstation Client is installed} -ArgumentList "--registration-token {bulk registration token}" -Wait` +6. To distribute the token to client computers during the allowed timeframe, you can use an automated script. + + For example, on Windows machines, you can use the following script: `& {path where the Workstation Client is installed} --registration-token {bulk registration token}`. + + On Linux machines, you can use the following script: `mendix-workstation --registration-token {bulk registration token}`. After the command runs or the token is entered manually, the Workstation Clients display the status **Waiting for station assignment**. This indicates that the clients are registered, but not yet associated with a specific station.