Neptune DXP - Open Edition 25.0.1 release notes
November 18, 2026
Upgrade notes
Version dependencies
Starting with Neptune DXP - Open Edition version 24.14.1, a new environment
variable SESSION_SECRET may be set. When upgrading from earlier versions (that
is to say, versions before 24.14.1), you must explicitly set this environment
variable during setup and ensure it is identical across all instances in multi-instance
or scaled deployments. If not configured consistently, each instance will generate
its own secret, which can lead to authentication failures (for example, users being
unable to log in due to mismatched session cookies).
|
-
Upgraded Node.js binary to Node.js 26.13.1 to stay aligned with current development and security enhancements of Node.js
Node.js upgrade from version 22 to version 26.13.1 in Neptune DXP - Open EditionThe following information applies to every upgrade to Neptune DXP - Open Edition 25.0.
-
Test your server script code in a QA system before upgrading your production system, as the Node.js upgrade might introduce breaking changes. Pay particular attention to custom or internally maintained npm modules, modules with native bindings, and code that uses deprecated or removed Node.js APIs.
-
Re-install and rebuild your custom npm modules with a local Node.js version of 26.13.1 or later.
-
Follow the migration checklist here.
-
If you upgrade from Neptune DXP - Open Edition 24.11.0 or earlier, also remove
node_sqlite3.nodefrom the root directory before running the Neptune DXP - Open Edition executable. If not removed, Neptune DXP - Open Edition will not start.
While you can run any Node.js 26 version, Neptune recommends running the same version as your Neptune DXP - Open Edition instance. -
-
Upgraded the default UI5 version to 1.148.9, which fixes issues with inputs inside table and tree controls.
Test your applications and launchpads that use the default UI5 version before you upgrade your production system.
Enhancements
Remote MCP Server
Neptune DXP - Open Edition 25.0.1 extends the Remote MCP Server with tools for most of the remaining design-time areas of the Cockpit. MCP clients can now maintain launchpads, connectors, fonts, translations, UI5 themes, and the Media Library, and upload files directly to the server. On the AI side, the tools cover AI guardrails, external agents, agent trace logs, and the setup of remote systems for AI Context Hub. Roles, security groups, and vault secrets are also available, and secret values never pass through the MCP server.
-
New tool groups:
-
Launchpads: list, read, create, update, and delete launchpads, assign tile groups to them, and configure their Launchpad Designer settings.
-
Connectors: manage connectors of every type (Table, Script, API, and SAP) and read their field catalogs.
-
Fonts, media library, translations (i18n), and UI5 themes: manage these artifacts, including browsing and searching the media library.
-
File uploads: upload a web app bundle, media files, ZIP archives into the media library, and font files. A file is passed by URL or uploaded directly to the server, so its content does not pass through the MCP client.
-
AI guardrails and agent trace logs: manage guardrails and their prompt versions, and read agent trace logs.
-
Remote systems and AI Context Hub: manage remote systems, test their connection, import tools from remote MCP servers, configure and start AI Context Hub ingestion for a SAP system, and read the ingested SAP services. The tools never return or set credentials. Authentication stays in the Remote Systems tool.
-
Roles and security groups: list, read, create, update, and delete.
-
Vault: manage the metadata of vault secrets and generate new secrets. Secret values never pass through the MCP server.
-
Naia Build: send a prompt from an MCP client to Naia Build in an open App Designer tab, follow the build, answer its questions, and check the result.
-
See: Tools overview
-
External (A2A) AI agents can now be created from an agent card URL, alongside standard agents.
-
The MCP server now authorizes through the general OAuth server, at
/mcp/oauth. TheOAUTH_TOKEN_SECRETenvironment variable replacesMCP_TOKEN_SECRET. ThemcpTokenSecretsetting and themcp_oauthtables were removed. -
The MCP authorization page has a new design and shows an expired page when a request can no longer be approved.
Media Library
-
A package can now be selected when creating a top folder. Media uploaded into the folder is added to that package.
Process Flows
-
An event can now start a process flow and pass its payload as interface data.
-
A process flow can now publish an event with the Trigger step.
-
Agent Tasks pass flow data to the prompt of the agent through Variables. A system variable takes the value of the user who runs the flow, not of the agent or flow designer. Existing Agent Tasks continue to work. Neptune recommends rebuilding them, because the new way of building context gives better results.
-
The process flow inbox texts can now be translated.
-
Server script logs show when the script runs inside a process flow.
-
The option to save intermediate process flow states has been removed.
Server
-
IN_PROCESS_CACHE_ENABLED=falseturns the in-process caches off. The in-process cache limits and ages are configurable throughIN_PROCESS_CACHE_*environment variables. -
POST /api/functions/Overview/Poolreturns the database pool counters and the query cache usage of every process of the instance: the main process, each web worker, the engine and its running job and script executors. The system monitor data carries the same counters per process. It requires the Cockpit overview permission. -
With
P9_PROMETHEUS_ENABLED, every web worker exposesp9_db_pool_connections(labelled bypidandstate),p9_query_cache_bytesandp9_query_cache_entriesthrough the cluster metrics endpoint, so the pool usage of all web workers can be scraped across instances. -
Jobs and scripts in a script executor wait the equivalent of
DB_PSQL_EXECUTOR_POOL_ACQUIRE_TIMEOUTorDB_MSSQL_EXECUTOR_POOL_ACQUIRE_TIMEOUTseconds (default 60) for a database connection.
Sessions
-
With
SESSION_STORE_REDIS=trueand Redis configured (DB_ENABLED_REDISwithDB_URI_REDIS), sessions are stored in Redis instead of thesessionstable. This removes the session read on every request and the expiry writes from the database. Redis is then required for login: if it is unreachable, requests fail and/healthzreports the session store as down. The cockpit session list and the session cleanup on user deletion work with both stores.
Bug fixes
AI Context Hub
-
Configured Services now marks ingested SAP services on PostgreSQL.
-
SAP engine ingestion saves its results again after upgrading to 25.0.0.
-
SAP engine ingestion no longer fails to save entity properties on fresh installs.
-
SAP engine OData ingestion now discovers services on SAP Gateway 7.50.
-
SAP engine ingestion on MSSQL no longer exceeds the 2100-parameter limit when saving metadata.
-
The SAP engine no longer shows a
{{placeholder}}instead of the value after a retry. -
The SAP engine no longer reuses a cached single-level plan to answer a multi-level query.
-
SAP engine result cards show function module values in full instead of as a clipped code block.
-
Agents no longer repeat the reply of an SAP data source below their own answer.
-
The playground query is no longer kept when switching between sources.
-
Queries no longer fail when the lightweight model is empty.
-
Expand all in the SAP Services tab of a remote system opens only the services, so large catalogs no longer freeze the browser.
-
The SAP Services toolbar of a remote system stays visible while scrolling the list.
AI Tools
-
Creating a script tool without a prompt and leaving without saving no longer shows a data changed warning when nothing was changed.
API
-
A script API with Run in own process enabled no longer fails on every call.
-
An API debugger condition can no longer be saved for a project that does not exist.
API Designer
-
Creating an API with Import Definition or API Discovery Service no longer fails with "endpoint: String must contain at least 1 character(s)" while the Endpoint field is hidden.
App Designer
-
Closing the initial dialog no longer causes the menu to render in the overflow.
-
Opening an app no longer sometimes shows an empty object tree and library.
-
The unused App Designer collaboration socket channel was removed. Its messages are ignored.
Cockpit
-
The Cockpit and designers use the neutral Neptune DXP 24 dark theme again.
-
The authentication provider image preview is hidden when the image is set to none.
-
Cockpit function bodies are now validated regardless of how the method name is cased.
-
The artifact filter now correctly handles the External API type.
-
Cockpit worker methods started over the socket now require the matching role and package access.
-
Changing the embedding model over the socket now requires System Settings access.
Connector
-
Saving an existing connector again no longer fails with a SAP API Factory validation error.
Fonts
-
Saving a font now requires edit access to its development package, and a package when one is mandatory.
Job Manage
-
Starting, cancelling, or watching a job over the socket now requires the Job Manage or System Processes role.
-
Running a job now requires edit access to the develpment package of the job.
-
The Run button is disabled for a job you cannot edit, and a refused run now shows the reason.
-
Importing a development package no longer fails for jobs whose Run as user does not exist in the target system.
Launchpad
-
The hover flyout for a navbar or sidebar tile no longer stays on screen.
-
The favorites tile no longer shows its icon twice in a navbar or sidebar.
-
Icons on a clickable tile and in a favorites row now show a pointer cursor.
-
The icon on a launchpad search filter no longer disappears when the filter is selected.
-
The launchpad now applies the configured Client Request Timeout to its requests.
-
A Client Request Timeout below the five-second minimum is ignored instead of disabling the timeout.
-
Apps in a launchpad now apply the Client Request Timeout to their API calls.
-
A PWA launchpad now applies an active blackout at startup and when it comes back online.
-
A launchpad created with the name of a deleted launchpad no longer returns 404 when run.
-
A launchpad without its own layout shows a changed default layout on the next reload.
-
A login provider button in a dark layout shows its light image when no dark image is set.
-
The users, PIN code, and login screens work again after signing out of a launchpad created in the Launchpad Designer.
-
Selecting a user with biometric login on the users screen now falls back to the passcode when the WebAuthn login fails or is cancelled, or the stored credential is unreadable.
-
A tile for an SAP app now says when SAP could not log the user on, for example because the password must be changed. Before, it showed a generic error such as "Session Timed Out".
-
A tile for an SAP app can be opened again after SAP could not log the user on.
-
Launchpad/GetDocreturns an empty list when the action type or its filter value is missing instead of listing all documentation.
Chatbox component
-
Agent info and the text on the launchpad chat button now truncate when space is limited.
-
Reloading the launchpad while the AI agent is open in fullscreen shows the AI agent again instead of an empty screen.
-
Adding
#neptune_chatboxto the URL no longer opens the fullscreen AI agent when the agent is shown in the side panel. -
Declining the microphone permission no longer causes an error loop.
-
Speech to text no longer fails in Microsoft Edge.
Launchpad Designer
-
Copy Tile and Copy Appearance now act on the tile copy that was selected.
-
Copy Appearance no longer selects the source tile.
-
Paste Appearance now selects the target tile in the preview.
-
Paste Appearance now repaints the pasted color swatches.
-
The menu chip now opens on every copy of a tile group placed more than once.
-
Selecting a tile group now suppresses the tile, tile group, and launchpad menus.
-
Selecting a suppressed menu chip now selects that control.
-
Each tile group in a navbar or sidebar now has its own outline and menu chip.
-
A selected screen or section now marks the menu chips of everything it owns.
-
A selected screen and section are outlined over the same extent as their hover.
-
Font Family can now be set without enabling the custom theme override.
-
Setting a font on its own now generates the font CSS, with no color theme.
-
A launchpad, its login page and the preview keep the font after saving.
-
A generated theme now applies in the preview without saving and reloading.
-
The Font Family placeholder now shows the font of a generated theme.
-
Saving in the designer no longer discards a concurrent appearance change.
Launchpad Layout
-
The Where-Used tab on a newly created layout no longer shows NaN.
-
The Where-Used count now includes the customizing light and dark layouts.
-
Copying a layout now resets its Where-Used count.
-
The Login Box button background hover color is applied on the launchpad login page.
-
The color picker preselects the theme color of a color field without a value.
-
The login page applies the Login Box field and button colors to hover, focus and pressed states, and to the login type list.
-
The Show Password checkbox on the login page keeps the corner radius of the theme.
Lock Entries
-
Listing lock entries now requires the Lock Entries role, and deleting them requires edit access.
Media Library
-
Media Library files load when the URL has a query string.
-
Searching for a media folder shows its subfolders.
-
Edit access is now checked against the development package of the folder actually targeted, including the own development package of a subfolder.
-
Uploads, ZIP imports, and folder updates now require edit access to the development package they assign, and no longer change the development package of a folder that already has one.
-
Folders can only be renamed in place, and the development package can only be changed on top folders.
-
Importing a ZIP file now checks edit access for every folder inside it.
-
File and folder names that contain slashes, or are "." or "..", are now rejected.
-
Media upload requires a development package when one is needed, and creating a media subfolder checks access to the package of the parent folder.
Mobile Client
-
Signing in with an SAP login that requires a password change no longer crashes the mobile client.
-
Submitting a new password after an SAP login asks for one no longer throws an error.
-
Hide Login Selection, Hide Local Login, and the other launchpad login settings now apply in the mobile client.
-
The default login IDP of the launchpad now applies in the mobile client.
-
A mobile build includes the background images, logos and icons set in the Launchpad Designer.
-
An Android mobile client no longer shows a taller header than the layout sets.
-
On iOS, the web view is no longer shifted down below the status bar. This left an empty strip at the top of the screen and pushed footer buttons under the home indicator.
-
On iOS, full-screen phone popups such as dropdown pickers and menus are inset by the safe area again, so they no longer render underneath the status bar and the home indicator.
-
On iOS, the configured status bar background is painted behind the status bar again. Before, the app background showed through, which made the clock and system icons unreadable in dark mode.
Naia Agent Studio
-
Agents with a remote MCP connection can use their MCP tools when run from a process flow or a server script.
-
Agent thread compaction works again.
Process Flows
-
Users no longer see all user tasks in the inbox of a process flow they initiate, unless they are in the approvers' group.
-
A process flow started from a server script on managed cloud can now read environment variables.
-
Table Interaction outputs now keep nested object structures instead of placing all properties at the same level.
-
Mappings inside nested body objects in Table Interaction nodes are now resolved correctly at runtime.
-
Generating outputs again in a Table Interaction node that already has generated outputs now works correctly.
-
Table Interaction nodes with a POST, PUT, or PATCH operation now return the saved rows, matching the generated outputs.
Remote MCP Server
-
Tool input is validated more strictly, so tools no longer create invalid artifacts. Parameters that take an ID are checked to be a UUID.
-
Deleting an ID that does not exist returns a "Not Found" response.
-
Security group, role, and connector tools check their input, such as development packages, roles, users, tables, scripts, and APIs, and return specific error messages instead of generic ones.
-
save_rolereturns the same fields as the get tool. -
save_tile_groupnow saves the title and the message formatter of a tile group. Updating only the message text keeps the formatter. -
save_apican now create nested properties, that is, children of an object or array property, in an API definition. -
Table APIs created through MCP now use Swagger 2.0 instead of OpenAPI 3.0.
Script Editor
-
Running or debugging a server script over the socket now requires Script Editor edit permission and edit access to the package of the script.
-
Listing API debugger conditions now requires the Script Editor role.
-
Saving or deleting an API debugger condition now requires edit access to its project.
Server
-
Upgrading from 24.14.5 on PostgreSQL no longer fails in the
planet9_events_logmigration when the event log holdsClearQueryCacheevents.
Stability and performance improvements
Authentication
-
A request without an
Authorizationheader or a configured token header no longer runs the Basic and JWT strategies before falling through to the session. -
A client that sends a Basic or JWT credential on every request gets its logon recorded in the user activity log and
lastLoginonce per five minutes per user and web worker instead of on every request. Session logins are recorded every time as before.
Launchpad
-
Launchpad/GetTilesreads each relation separately instead of in one joined query, which cost about 500 ms of database CPU and 98,000 page reads per call on a copy of a production database. The launchpad structure is cached per web worker for one minute, and the images inlined for mobile clients for five minutes. Saving a launchpad or any of its parts clears the cache in every process at once. -
Launchpad/GetUserInfosends about 50 KB less on every login.
Server
-
A database error no longer restarts the web worker, and an error after a response has started no longer crashes it.
-
A request that cannot get a database connection within
DB_PSQL_POOL_ACQUIRE_TIMEOUTorDB_MSSQL_POOL_ACQUIRE_TIMEOUTseconds (default 10) fails with 503 instead of waiting indefinitely. -
Data read on nearly every request, such as users, roles, apps, launchpads, customizing and script APIs, is cached per web worker or no longer read on every call. Saving clears the cache in every process at once. The global admin roles, ACL lists and other query-cached data reach the other web workers within one minute.
-
Compiled apps and web app assets are served from memory. App view ETags are derived from the app version, so a browser revalidating against a different server gets a 304.
-
The app access log no longer delays the app response, and the log file size limit holds when several processes write to the same file.
Sessions
-
A session’s expiry is extended at most once per minute instead of on every request, and concurrent requests that find it due share one write.
-
While Redis is unreachable, requests answer 503 with a session store message instead of a generic error page, and the outage is logged once instead of per request.
More information
Are you looking for more information? To access full details of the technical changelog for Neptune DXP - Open Edition 25.0.1, please contact Neptune directly.
If you experience any problems with this release, please contact Neptune Support.