You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/refguide/runtime/custom-settings/_index.md
+2-1Lines changed: 2 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -146,7 +146,6 @@ The settings below influence the behavior of the log files. These settings can o
146
146
| <aid="DataStorageEnableDiagnostics"href="#DataStorageEnableDiagnostics">DataStorage.EnableDiagnostics</a> | This setting can be used to generate a uniqueness constraint violation report. | false |
147
147
| <aid="UseNetworkTimeout"href="#UseNetworkTimeout">UseNetworkTimeout</a> | This setting is applied to PostgreSQL. It affects the timeout mechanism used when reserving new ids for Mendix objects. If set to true, the socket level request timeout is used. In that case, the request timeout is handled within the operating system. If set to false, the timeout is handled by Mendix runtime. For other databases, timeouts are always handled by Mendix runtime. | true |
148
148
| <aid="JdbcLoginTimeout"href="#JdbcLoginTimeout">JdbcLoginTimeout</a> | This setting defines the database connection establishment time in milliseconds. | 5000 (5 seconds) |
149
-
| <aid="SynchronizationCleanupInterval"href="#SynchronizationCleanupInterval">com.mendix.offline.SynchronizationCleanupInterval</a> | This setting defines how often objects of type `System.OfflineSynchronizationHistory` are cleaned up. | 90 (90 days) |
150
149
| <aid="DataStorageOptimizeSecurityColumns"href="#DataStorageOptimizeSecurityColumns">DataStorage.OptimizeSecurityColumns</a> | When true, query columns generated to evaluate XPath constraints in access rules are optimized to `true` if the runtime can determine that the value will always be true for the objects that the query returns. This is almost always an improvement, but we have seen cases where the PostgreSQL query planner has worse performance for the simpler query. | true |
151
150
152
151
### Connection Pooling {#connection-pooling}
@@ -286,6 +285,8 @@ The settings below influence the behavior of the Mendix web client.
286
285
| Name | Description | Default Value |
287
286
| --- | --- | --- |
288
287
| <aid="EnableKeepAlive"href="#EnableKeepAlive">EnableKeepAlive</a> | Defines whether the web client sends a keep alive request every `SessionTimeout`/2 milliseconds in order to prevent a session timeout. Each click in the browser also acts as `KeepAlive`. Disabling this property will result in the user being logged out automatically after `SessionTimeout` milliseconds of inactivity (default 10 minutes), even if the browser remains open. See `SessionTimeout` in the next section for more information. | true |
288
+
| <aid="DeleteAutoCommittedObjectsAfterSync"href="#DeleteAutoCommittedObjectsAfterSync">com.mendix.offline.DeleteAutoCommittedObjectsAfterSync</a> | Defines if auto-committed created during offline synchronization will be deleted from the database immediately.<br/>*Deprecated – should only be changed if you have compatibility issues upgrading from Mendix version 9.*| true |
289
+
| <aid="SynchronizationCleanupInterval"href="#SynchronizationCleanupInterval">com.mendix.offline.SynchronizationCleanupInterval</a> | This setting defines how often objects of type `System.OfflineSynchronizationHistory` are cleaned up. | 90 (90 days) |
289
290
| <aid="commendixwebuiAuthTokenTimeout"href="#commendixwebuiAuthTokenTimeout">com.<wbr>mendix.<wbr>webui.<wbr>AuthTokenTimeout</a> | Determines how many minutes your token will remain valid before re-authenticating using your full credentials. If no value is set, the token will expire after One year. | Introduced in Mendix 11.3. Use [com.<wbr>mendix.<wbr>webui.<wbr>HybridAppLoginTimeOut](#commendixwebuiHybridAppLoginTimeOut) in earlier versions. |
290
291
| <aid="commendixwebuiHybridAppLoginTimeOut"href="#commendixwebuiHybridAppLoginTimeOut">com.<wbr>mendix.<wbr>webui.<wbr>HybridAppLoginTimeOut</a> | Legacy alias of <aid="commendixwebuiAuthTokenTimeout"href="#commendixwebuiAuthTokenTimeout">com.<wbr>mendix.<wbr>webui.<wbr>AuthTokenTimeout</a> ||
291
292
| <aid="commendixwebuiFeedbackSizeWarningThreshold"href="#commendixwebuiFeedbackSizeWarningThreshold">com.<wbr>mendix.<wbr>webui.<wbr>FeedbackSizeWarningThreshold</a> | A warning is logged when the feedback size exceeds the threshold. Feedback is sent from server to client to instruct (for example, to refresh objects or to open a page). They are serialized as "instructions" in the server response. If there are too many instructions, this can have performance implications, as they all have to be serialized to the client. For this reason, a warning is logged when the threshold is exceeded. | 5000 |
Copy file name to clipboardExpand all lines: content/en/docs/refguide/runtime/custom-settings/tricky-custom-runtime-settings.md
-1Lines changed: 0 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,6 @@ The following custom settings can be configured:
28
28
| Name | Description | Default value |
29
29
| --- | --- | --- |
30
30
|`SessionTimeout`| Defines after how much time the session becomes invalid (in milliseconds). After that timeout, a session becomes applicable for removal. The session won't be destroyed until the next time the cluster manager evaluates the active sessions. | 600000 (10 minutes) |
31
-
|`com.mendix.offline.DeleteAutoCommittedObjectsAfterSync`| Defines if auto-committed created during offline synchronization will be deleted from the database immediately. | true |
32
31
|`ClusterManagerActionInterval`| The interval (in milliseconds) used for performing all cluster manager actions. These actions include unblocking users and removing invalid sessions. If nothing is specified, the interval is half the `SessionTimeout`. | 300000 (5 minutes) |
33
32
|`SessionKeepAliveUpdatesInterval`| Defines after how much time expired sessions can be removed from the database. | one sixth of the value configured for the `SessionTimeout` setting; if the `SessionTimeout` is not set, this value defaults to 100000 (100 seconds) |
Copy file name to clipboardExpand all lines: content/en/docs/releasenotes/workstation/_index.md
+32-1Lines changed: 32 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -10,6 +10,37 @@ cascade:
10
10
11
11
These release notes cover changes made to the [Mendix Workstation](/mendix-workstation/).
12
12
13
+
## 3.7.0
14
+
15
+
### Release date: May 21, 2026
16
+
17
+
### Workstation Management
18
+
19
+
#### New features
20
+
21
+
* Smart configuration updates (auto-refresh) - You can now choose if your workstation configurations should automatically update when changes are made, or if you prefer to trigger updates manually. This gives you more control and ensures your workstations always have the correct settings with less effort.
22
+
* Real-time workstation status - The Workstation Management UI now shows the live configuration status of each Workstation Client, letting you quickly see if a workstation is **Up to Date** or **Outdated**. This provides immediate insight into your deployment's health.
23
+
* Enhanced Serial Device detection settings - You can now configure Workstation Management to identify your serial devices using more reliable information like their Friendly Name, Serial Number, or Manufacturer. This helps your Workstation Clients reliably find and connect to the correct serial device, even if its port number changes.
24
+
25
+
#### Improvements
26
+
27
+
* Configurable auto-refresh behavior - We have provided options for how auto-refresh works, including default settings for workspaces and how clients respond in both automatic and manual modes. This allows for flexible management of your workstation configurations.
28
+
29
+
#### Bug Fixes
30
+
31
+
* UI inconsistencies - We have fixed several visual inconsistencies in the Management UI, particularly improving the display and user experience when using dark mode. This makes the interface cleaner and more consistent for everyone.
32
+
33
+
### Workstation Client
34
+
35
+
#### New Features
36
+
37
+
* Automatic Client startup - The Workstation Client application now automatically launches silently in the background when your system starts up. This ensures your workstations are always ready to go without needing manual intervention after a reboot.
38
+
* Smart Serial Device finder - The client can now use the Friendly Name, Serial Number, or Manufacturer to find and connect to serial devices. This means your client can reliably connect to the right device even if its assigned port changes.
39
+
40
+
#### Improvements
41
+
42
+
* Granular configuration change response - The client now handles configuration changes more smoothly and with less downtime. This means your stations will experience fewer interruptions and apply new settings more efficiently.
43
+
13
44
## 3.6.1
14
45
15
46
### Release date: April 28, 2026
@@ -64,7 +95,7 @@ If more than one station is found for a given computer name during bulk registra
64
95
65
96
For more information, see [Nanoflows](/mendix-workstation/build-app/#javascript-actions) and [Widgets](/mendix-workstation/build-app/#widgets).
66
97
67
-
#### Improvement
98
+
#### Improvements
68
99
69
100
* The **Model Peripheral** entity is now a specialization of the **Device** entity and no longer requires association.
70
101
* Calling `GetStation` is no longer required to initiate the Workstation Connector. It is only required to read the station configuration.
Copy file name to clipboardExpand all lines: content/en/docs/workstation/wks-batch-registration.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -13,6 +13,10 @@ The registration process is a necessary first step when enabling this crucial fu
13
13
14
14
Mendix Workstation supports both individual registration of local Workstation clients, and bulk rollouts for large production environments.
15
15
16
+
{{% alert color="info" %}}
17
+
After a Workstation Client is registered, any changes that you make in Workstation Management (such as adding new devices, or setting the **Detect Card Readers** toggle to **Off**) will be immediately synchronized with the Client. To change this behavior, see [Client's Auto-Refresh](/mendix-workstation/installation/#auto-refresh).
18
+
{{% /alert %}}
19
+
16
20
## Registering a Single Workstation Client
17
21
18
22
If you are developing or testing Workstation configurations, you can register a single Workstation Client for your local computer by performing the following steps:
Any changes that you make in Workstation Management (such as adding new devices, or setting the **Detect Card Readers** toggle to **Off**) will be immediately synchronized with the Workstation Client. To change this behavior, see [Client's Auto-Refresh](#auto-refresh).
100
+
99
101
### Configuring and Testing Virtual Devices
100
102
101
103
After registering your computer, test your connectivity by creating a pair of virtual devices: a TCP/IP server that will emulate a device, and a TCP/IP client that will connect to the emulated device.
102
104
103
105
#### Creating a TCP/IP Server
104
106
105
107
1. Go to [Mendix Workstation Management](https://workstation.home.mendix.com/).
106
-
2. In the **Station** page, click **Add Device**.
108
+
2. In the **Station Details** page, click **Add Device**.
107
109
3. Select **TCP/IP Server** as the **Device Type**, and then click **Next**.
108
110
4. In the **Device Name** field, enter **Test Server**
109
111
5. In the **Device Class** field, select or create a class (for example, *Virtual*), and then click **Next**.
@@ -119,7 +121,7 @@ The emulated device, a local TCP/IP server listening on port 1705, is added to t
119
121
#### Creating a TCP/IP Client
120
122
121
123
1. Go to [Mendix Workstation Management](https://workstation.home.mendix.com/).
122
-
2. In the **Station** page, click **Add Device**.
124
+
2. In the **Station Details** page, click **Add Device**.
123
125
3. Select **TCP/IP Client** as the **Device Type**, and then click **Next**.
124
126
4. In the **Device Name** field, enter **Test Client**, and then click **Next**.
125
127
5. In the **Device Class** field, select or create a class (for example, *Virtual*), and then click **Next**.
@@ -153,7 +155,7 @@ Different device types have different requirements for the message syntax. For m
153
155
154
156
### Quitting the Workstation Client
155
157
156
-
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](#developer-mode) is enabled. Alternatively, the Workstation Client process can always be stopped via Windows Task Manager.
158
+
The Workstation Client runs automatically at system startup. 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](#developer-mode) is enabled. Alternatively, the Workstation Client process can always be stopped via Windows Task Manager.
157
159
158
160
## Advanced Configurations
159
161
@@ -167,6 +169,8 @@ Navigate to the **Settings** page in a workspace to configure settings that are
167
169
168
170
#### Log Settings
169
171
172
+
Log settings are available in Workstation Management at **Settings > Log Settings**.
173
+
170
174
The Workstation Client always stores logs to the file system it is installed on (c.f. [Troubleshooting - Workstation Client](/mendix-workstation/troubleshooting/#workstation-client)). No logs are send to the Workstation Management. However, you can configure the log level and retention policy of all the Workstation Clients that are registered to stations in the workspace.
171
175
172
176
##### Log Level
@@ -186,9 +190,21 @@ Verbosity and thus log file size increases with each log level. To constrain thi
186
190
187
191
Modify these settings to the needs of your logging policy, especially if you require to keep debug level logs in production for retrospective troubleshooting.
188
192
193
+
#### Client's Auto-Refresh {#auto-refresh}
194
+
195
+
Auto-refresh settings are available in Workstation Management at **Settings > Client's Auto-Refresh**.
196
+
197
+
By default, the Workstation Client operates in auto-refresh mode. That is, any changes made to the configuration in Workstation Management are immediately reflected in the Client.
198
+
199
+
To change this behavior, set the **Auto-Refresh Mode** toggle to **Off**. You can then force the configuration to refresh by clicking **Refresh on Computer** in Workstation Management, or by clicking **Refresh** in the Workstation Client.
200
+
201
+
The **Check Interval** setting is only available when the auto-refresh mode is enabled. It specifies how often a Workstation Client that is disconnected due to a web socket failure should automatically refresh its configuration by polling Workstation Management. By default, this happens every 60 minutes.
202
+
189
203
#### Local Device Testing
190
204
191
-
By default, the Workstation Management is pre-configured as an allowed app to connect to the Workstation Client on the **Test your Station** page in a workspace. To disable this, navigate to the tab "Local Device Testing" on the **Settings** page and toggle it off.
205
+
Local device testing settings are available in Workstation Management at **Settings > Local Device Testing**.
206
+
207
+
By default, the Workstation Management is pre-configured as an allowed app to connect to the Workstation Client on the **Test your Station** page in a workspace. To disable this setting, toggle it off.
192
208
193
209
### Workspace Team and Collaboration {#collaboration}
0 commit comments