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 Edition

    The 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.node from 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.

  • 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. The OAUTH_TOKEN_SECRET environment variable replaces MCP_TOKEN_SECRET. The mcpTokenSecret setting and the mcp_oauth tables were removed.

  • The MCP authorization page has a new design and shows an expired page when a request can no longer be approved.

Cockpit

  • A new global search finds tools, tiles, artifacts and the actions of the current app.

Launchpad Designer

  • The Tiles, Tile Groups, Navbar and Sidebar tabs show their member count.

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.

Script Editor

  • P9_SCRIPT_DEBUGGER_DISABLED=1 turns the server script debugger off.

Server

  • IN_PROCESS_CACHE_ENABLED=false turns the in-process caches off. The in-process cache limits and ages are configurable through IN_PROCESS_CACHE_* environment variables.

  • POST /api/functions/Overview/Pool returns 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 exposes p9_db_pool_connections (labelled by pid and state), p9_query_cache_bytes and p9_query_cache_entries through 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_TIMEOUT or DB_MSSQL_EXECUTOR_POOL_ACQUIRE_TIMEOUT seconds (default 60) for a database connection.

Sessions

  • With SESSION_STORE_REDIS=true and Redis configured (DB_ENABLED_REDIS with DB_URI_REDIS), sessions are stored in Redis instead of the sessions table. 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 /healthz reports the session store as down. The cockpit session list and the session cleanup on user deletion work with both stores.

User launchpad experience

  • Sign-in screens show the main action as a full-width button, with Cancel as a link below it.

Bug fixes

Adaptive Designer

  • The Create dialog now scrolls correctly.

Adaptive templates

  • Clearing a variant no longer removes hidden filters and navigation key fields.

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 Guardrails

  • Development packages are now displayed correctly in the artifact 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.

Authentication

  • Importing security groups from LDAP no longer fails with a UTF8 error.

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.

Custom UI5 Control

  • Errors from previously opened controls no longer stop new controls from saving.

Development Package

  • Adding roles to a package no longer resets the Action of roles already on it.

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/GetDoc returns 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_chatbox to 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_role returns the same fields as the get tool.

  • save_tile_group now saves the title and the message formatter of a tile group. Updating only the message text keeps the formatter.

  • save_api can 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_log migration when the event log holds ClearQueryCache events.

System Processes

  • The live monitor data stream now requires System Processes or Job Manage access.

Table Definition

  • Legacy tables with empty or text default values no longer fail with validation errors.

UI5 Theme Generator

  • An empty Foreground Border Color no longer produces fully saturated borders.

Web App Manager

  • Exporting a web app as a ZIP file no longer corrupts binary files.

  • Importing a ZIP file into a web app no longer overwrites a web app locked by another user.

Stability and performance improvements

AI Context Hub

  • Expanding and collapsing entries in the SAP application hierarchy is faster.

Authentication

  • A request without an Authorization header 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 lastLogin once per five minutes per user and web worker instead of on every request. Session logins are recorded every time as before.

Launchpad

  • Launchpad/GetTiles reads 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/GetUserInfo sends 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_TIMEOUT or DB_MSSQL_POOL_ACQUIRE_TIMEOUT seconds (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.

Was this page helpful?

What made the biggest difference for you?
What went wrong? (Your feedback helps us fix it.)

Please don't include personal or sensitive data.