Skip to content

Mockoon Release Notes

Mockoon · Design and run local mock APIs with configurable routes, realistic JSON responses, OpenAPI import, request logs, proxy forwarding and HTTPS.

CaskDeveloper ToolsAuto-updates 8.5K
Install command
brew install --cask mockoon
30-day installs
300
#548 in App
1-year installs
5.1K
Last 365 days
Latest version
9.10.0
Download size
131MB
dmg
Release cadence
Irregular
0 releases in 30 days
  1. 9.10.0

    Latest

    OpenNavo editorial

    CompatibilitymacOS 13 or later

    Mockoon Pro leaves beta with workspaces and workspace access rights, plus mixed authentication, undo for deleted entities, and a TLS verification flag in the CLI.

    • Mockoon Pro is generally available after its public beta, with real-time collaboration, remote mock API deployments, an embedded web app, enterprise authentication and administration tools on your own infrastructure.
    • Pro workspaces let organizations split remote mock APIs between teams and projects and control who can see, edit, sync and deploy each environment. Existing installations migrate automatically to a Default workspace.
    • Mixed authentication lets local username and password accounts run alongside OpenID Connect Single Sign-On.
    • Owners can change team member roles between User and Owner in the administration portal, with safeguards against self-changes, demoting the last Owner or changing a disabled account. Changes are recorded in the audit trail.
    • Synchronized environments now migrate automatically during major-version upgrades.
    • Changes to Pro instance settings are logged in the audit trail.
    • Deleted entity notifications now offer an undo action.
    • The CLI has a new --proxy-verify-tls flag that validates TLS certificates when proxying requests to HTTPS APIs. Validation stays off by default, and the app warns when an HTTPS proxy target runs without certificate validation.
    • Notifications use a new design with a neutral background, clear border, colored status accent and icon.
    • Pro terminology changed: cloud environments are now remote environments, the desktop app shows Local and Remote sections, and the sign-in action is now Connect.
    • Fixed switching from the legacy Mockoon Cloud service to a self-hosted Pro instance leaving synchronization on the previous API URL, which could retry indefinitely after an unauthorized response.
    • Fixed a synchronization propagation issue after a remote environment was deleted or converted to local.
    • Updated dependencies across the desktop and web apps, CLI, libraries, backend services and Docker images.

    Official release notes

  2. 9.9.0

    OpenNavo editorial Added to Homebrew

    CompatibilitymacOS 13 or later

    Fixes multipart prototype pollution, improves log search and CRUD ID generation, respects Content-Type charsets, and adds OpenAPI remote-reference warnings.

    Changes
    Fixes multipart form-data prototype pollution (GHSA-cmwm-hp2w-h3cx).Searches request and response bodies and headers in Logs.Reuses existing CRUD ID strategies and respects explicit Content-Type.Warns before fetching remote OpenAPI references.

    Welcome to this new release of Mockoon. It brings support for connecting to a self-hosted API in the future, WebSocket support in Mockoon Cloud, a smarter CRUD auto-generated ID strategy, Content-Type charset override, and several bug fixes and improvements. Read on to learn more about this release.

     Support us!

    Mockoon is proudly independent and open-source, maintained without external funding. We rely on both sponsorships and Mockoon Cloud subscriptions to keep improving the project and building new features. A big thank you to the companies below for supporting our work and helping us grow (and all the sponsors who helped this project over time!):

    If you'd like to support Mockoon as well, you can become a sponsor or subscribe to Mockoon Cloud. Every contribution helps keep the project alive and evolving. Thank you!

     WebSocket support in Mockoon Cloud

    As part of the work on the self-hosted backend (see below), Mockoon Cloud now supports WebSocket endpoints. They work similarly to their local counterparts, allowing real-time communication between clients and the server.

    Head over to the WebSocket documentation to learn more about how to set up and use WebSocket endpoints in Mockoon.

    (PR #2354)

     Deprecation of the @mockoon/serverless library

    The @mockoon/serverless package is now formally deprecated and will no longer receive new feature updates.

    We recommend using the official Mockoon CLI Docker image instead when running mocks on serverless platforms such as AWS Lambda or Google Cloud Run. We plan to remove the @mockoon/serverless package entirely in a future major release.

    (Issue #2079)

     Preparation for self-hosted API

    The desktop and web applications have been updated to support connecting to a self-hosted Mockoon backend.

    We announced earlier this year that self-hosting would be our focus for the rest of 2026.

    Nothing to see yet, but a self-hosted backend supporting Mockoon Cloud features will soon be available as a paid product. Stay tuned for more updates as development progresses.

    (PR #2354)

     Improvements

    Mockoon now respects explicit Content-Type header definitions on your responses without automatically forcing a charset=utf-8 suffix, giving you full control over response headers and non-UTF-8 payload encodings. More details can be found in the response headers documentation. (Issue #539)

    When opening an environment via custom protocol (mockoon://), the application now prompts for the destination save path before fetching the remote file, making remote imports clearer and providing smoother cancellation handling. (PR #2341)

    The Logs tab search has been enhanced to include request and response bodies as well as headers, alongside the URL path, HTTP method, and status code. This makes debugging much easier when working with identical URLs (such as GraphQL endpoints) or searching for specific headers and payload properties without having to manually inspect every logged transaction. (Issue #1881)

    When importing an OpenAPI specification that contains remote $ref references, Mockoon will now warn you before dereferencing and fetching external URLs, listing the target endpoints for greater visibility and security. In addition, a new CLI flag has been added to disable remote URL dereferencing during automated OpenAPI imports: --disable-external-refs. (Issue #2339)

    CRUD routes now detect the format and templating helpers used for existing item IDs in your data bucket (such as UUIDs, auto-incrementing numbers, or helpers like {{faker 'database.mongodbObjectId'}}) and automatically reuse that strategy when auto-generating new record IDs upon POST requests. Read more in the CRUD routes documentation. (Issue #1547)

     Fixes

    Fixed an issue where templated file paths in responses were erroneously blocked by path traversal checks. (Issue #2319)

    Fixed an issue where non-TLS HTTP/2 requests with upgrade headers failed with an Invalid WebSocket upgrade request error when WebSocket routes were defined. (Issue #1908)

    Fixed an issue where the Secure cookie flag was not removed when proxying HTTPS services over plain HTTP. (Issue #611)

    Removed the append-field dependency and improved multipart form-data parsing with nested/indexed fields handling and prototype pollution protection. A prototype pollution vulnerability was fixed where specially crafted multipart form-data field names could modify Object prototype properties on the server runtime. We recommend updating to this version as soon as possible if your mocks process untrusted requests or are exposed publicly. This vulnerability was disclosed in GHSA-cmwm-hp2w-h3cx. Read our security update. (PR #2355)

     Chores

    Migrated automated end-to-end desktop test mocking to WDIO Electron mocks. (PR #2258)

    Updated application and library dependencies to their latest versions. (PR #2356)

    GitHub release notice: Full changelog

    Source: https://mockoon.com/releases/9.9.0/ Official release: https://github.com/mockoon/mockoon/releases/tag/v9.9.0

  3. 9.6.1

    Expand

    OpenNavo editorial Added to Homebrew

    Fixes macOS builds broken in 9.6.0. The official page also reproduces the preceding 9.6.0 feature notes.

    Changes
    Fixes broken macOS builds introduced by 9.6.0.

    Patch 9.6.1 fixes the following issues

    Fixed an issue breaking the macOS builds since v9.6.0. (Issue #2151)

     v9.6.0 release notes

    Welcome to this new release of Mockoon. It brings many improvements, including OpenAPI re-import, no more server restarts, and live updates for cloud mocks. Read on to learn more about this release.

     Support us!

    Mockoon is proudly independent and open-source, maintained without external funding. We rely on both sponsorships and Mockoon Cloud subscriptions to keep improving the project and building new features. A big thank you to the companies below for supporting our work and helping us grow (and all the sponsors who helped this project over time!):

    If you'd like to support Mockoon as well, you can become a sponsor or subscribe to Mockoon Cloud. Every contribution helps keep the project alive and evolving. Thank you!

     OpenAPI re-import

    You can now re-import an OpenAPI specification in an existing mock to update it with the new specification content:

    The option is available in each mock's dropdown menu and will show a summary of the changes that will be applied to the mock before confirming the re-import.

    Currently, the following changes can be applied when re-importing an OpenAPI specification:

    new routes, based on the path and method.

    new responses, based on the status codes present in each route.

    Learn more about OpenAPI re-import

    (Issue #765)

     Goodbye server restarts!

    Starting with this release, mock servers no longer need to be restarted when you make changes to most of the mock configuration.

    In the past, part of the changes made to the mock configuration were applied immediately (responses, callbacks, headers, rules, etc.) while other changes like adding or removing a route, or changing a route path and method, required a server restart to be applied.

    All changes are now applied immediately without the need to restart the server, which should make the development experience smoother and faster. This includes modifications made to data buckets, adding, removing, reordering, or modifying a route (e.g. updating the path or method), changing the server prefix or latency, enabling/disabling the proxy, etc. The only changes that still require a server restart are related to TLS configuration and the hostname/port of the server.

    This behavior is always enabled in the desktop application. When self-hosting with the CLI or Docker image, the running mock can be updated in the same way using the admin API endpoints. For our Cloud users, the running mock is automatically updated when the live update option is enabled (see below).

    [⚠️ potential breaking change] To achieve this, we reimplemented route matching using the path-to-regexp library instead of relying on Express.js routing. We decided to use the latest version, which includes some breaking changes (also part of Express 5), notably wildcards requiring a name: /* → /*wildcard. We ensured backward compatibility by automatically converting old syntaxes to the new ones allowing you to use the one you prefer (Express 4 or Express 5 style). However, some regex syntaxes are no longer supported, especially the one using brackets, /[discussion|page], which should be replaced by a parameter, a wildcard, or a rule. You will find more details about the supported route path syntaxes in our updated routing documentation.

    (Issue #2078)

     Cloud live updates

    Until now, updating a Cloud mock from the desktop application or the web application did not produce the same result: the desktop application always required a manual redeploy to apply changes, while the web application propagated changes immediately without redeploying. With this release, we are aligning the behavior of both applications by introducing a new live update option in the deployment dialog:

    When enabled, the live update option allows you to apply changes to your Cloud mock immediately without needing to redeploy it. This means that any changes made to the mock configuration are propagated to the running mock in real time, including changes that previously required a redeploy (e.g. adding a route, changing a route path, or changing a route method, see above). When disabled, the behavior remains the same as before, and you need to redeploy the mock manually to apply changes.

    (Issue #2135)

     Command palette - Recently used commands

    The command palette now shows a list of recently used commands, allowing you to quickly access and execute them again:

    (Issue #2036)

     Improvements

    "Header" rules now support auto-completion for header names and values. (Issue #2038)

    Two new helpers were added to encode/decode to and from URL safe base64: {{base64url}} and {{base64urlDecode}}. (Issue #2058)

    Two new helpers were added to replace one or all occurrences of a string: {{replace}} and {{replaceAll}}. (Issue #2059)

    Support was added for number enums when importing OpenAPI specifications. (Issue #2113)

    The oneOf template helper now supports a simplified syntax: {{oneOf 'value1' 'value2' 'value3'}}. The old syntax {{oneOf array}} (where array is an array of values coming from another helper or variable) is still supported. Newly imported OpenAPI specifications will use the simplified syntax. (Issue #2109)

     Fixes

    stringify template helper compatibility with other helpers was improved. (Issue #2060)

    The request Content-Type check, on which JSON parsing depends, is now case-insensitive. (Issue #2093)

    (Partially) fixed an issue where the Mockoon Snap version was unable to start correctly since v9.4.0. (Issue #1909)

    Fixed desktop application installation failing on some Linux distributions due to conflicting files. (Issue #2064)

    Logs now contain a UUID field to uniquely identify and deduplicate them. (Issue #2037)

    Switching between "CERT" and "PFX" settings in the TLS configuration now correctly uses the self-signed certificate even when PFX settings are filled. (Issue #2118)

     Chores

    We updated the libraries and application dependencies to their latest versions to fix several vulnerabilities.

    We updated the application to Angular 21 which allowed us to remove some dependencies. (Issue #2127)

     Thank you

    A big thank you to the following people who helped to make Mockoon better:

    @rohanakode490: Command palette's recently used commands, header rules auto-completion, URL safe base64 helpers, string replace helpers, stringify helper improvements.

    GitHub release notice: Full changelog

    Source: https://mockoon.com/releases/9.6.1/ Official release: https://github.com/mockoon/mockoon/releases/tag/v9.6.1

  4. 9.6.0

    Expand

    OpenNavo editorial Added to Homebrew

    Adds OpenAPI re-import, live mock-configuration updates and Cloud live updates. Changes route matching and adds templating helpers; macOS builds are broken.

    Changes
    Adds OpenAPI re-import for new routes and responses.Applies most mock configuration changes without a restart.Adds optional Cloud live updates and recent command-palette commands.Migrates route matching; some old regex path forms are unsupported.Adds URL-safe base64 and string-replacement helpers.Warning: macOS builds are broken; upstream recommends 9.6.1.

    Welcome to this new release of Mockoon. It brings many improvements, including OpenAPI re-import, no more server restarts, and live updates for cloud mocks. Read on to learn more about this release.

     Support us!

    Mockoon is proudly independent and open-source, maintained without external funding. We rely on both sponsorships and Mockoon Cloud subscriptions to keep improving the project and building new features. A big thank you to the companies below for supporting our work and helping us grow (and all the sponsors who helped this project over time!):

    If you'd like to support Mockoon as well, you can become a sponsor or subscribe to Mockoon Cloud. Every contribution helps keep the project alive and evolving. Thank you!

     OpenAPI re-import

    You can now re-import an OpenAPI specification in an existing mock to update it with the new specification content:

    The option is available in each mock's dropdown menu and will show a summary of the changes that will be applied to the mock before confirming the re-import.

    Currently, the following changes can be applied when re-importing an OpenAPI specification:

    new routes, based on the path and method.

    new responses, based on the status codes present in each route.

    Learn more about OpenAPI re-import

    (Issue #765)

     Goodbye server restarts!

    Starting with this release, mock servers no longer need to be restarted when you make changes to most of the mock configuration.

    In the past, part of the changes made to the mock configuration were applied immediately (responses, callbacks, headers, rules, etc.) while other changes like adding or removing a route, or changing a route path and method, required a server restart to be applied.

    All changes are now applied immediately without the need to restart the server, which should make the development experience smoother and faster. This includes modifications made to data buckets, adding, removing, reordering, or modifying a route (e.g. updating the path or method), changing the server prefix or latency, enabling/disabling the proxy, etc. The only changes that still require a server restart are related to TLS configuration and the hostname/port of the server.

    This behavior is always enabled in the desktop application. When self-hosting with the CLI or Docker image, the running mock can be updated in the same way using the admin API endpoints. For our Cloud users, the running mock is automatically updated when the live update option is enabled (see below).

    [⚠️ potential breaking change] To achieve this, we reimplemented route matching using the path-to-regexp library instead of relying on Express.js routing. We decided to use the latest version, which includes some breaking changes (also part of Express 5), notably wildcards requiring a name: /* → /*wildcard. We ensured backward compatibility by automatically converting old syntaxes to the new ones allowing you to use the one you prefer (Express 4 or Express 5 style). However, some regex syntaxes are no longer supported, especially the one using brackets, /[discussion|page], which should be replaced by a parameter, a wildcard, or a rule. You will find more details about the supported route path syntaxes in our updated routing documentation.

    (Issue #2078)

     Cloud live updates

    Until now, updating a Cloud mock from the desktop application or the web application did not produce the same result: the desktop application always required a manual redeploy to apply changes, while the web application propagated changes immediately without redeploying. With this release, we are aligning the behavior of both applications by introducing a new live update option in the deployment dialog:

    When enabled, the live update option allows you to apply changes to your Cloud mock immediately without needing to redeploy it. This means that any changes made to the mock configuration are propagated to the running mock in real time, including changes that previously required a redeploy (e.g. adding a route, changing a route path, or changing a route method, see above). When disabled, the behavior remains the same as before, and you need to redeploy the mock manually to apply changes.

    (Issue #2135)

     Command palette - Recently used commands

    The command palette now shows a list of recently used commands, allowing you to quickly access and execute them again:

    (Issue #2036)

     Improvements

    "Header" rules now support auto-completion for header names and values. (Issue #2038)

    Two new helpers were added to encode/decode to and from URL safe base64: {{base64url}} and {{base64urlDecode}}. (Issue #2058)

    Two new helpers were added to replace one or all occurrences of a string: {{replace}} and {{replaceAll}}. (Issue #2059)

    Support was added for number enums when importing OpenAPI specifications. (Issue #2113)

    The oneOf template helper now supports a simplified syntax: {{oneOf 'value1' 'value2' 'value3'}}. The old syntax {{oneOf array}} (where array is an array of values coming from another helper or variable) is still supported. Newly imported OpenAPI specifications will use the simplified syntax. (Issue #2109)

     Fixes

    stringify template helper compatibility with other helpers was improved. (Issue #2060)

    The request Content-Type check, on which JSON parsing depends, is now case-insensitive. (Issue #2093)

    (Partially) fixed an issue where the Mockoon Snap version was unable to start correctly since v9.4.0. (Issue #1909)

    Fixed desktop application installation failing on some Linux distributions due to conflicting files. (Issue #2064)

    Logs now contain a UUID field to uniquely identify and deduplicate them. (Issue #2037)

    Switching between "CERT" and "PFX" settings in the TLS configuration now correctly uses the self-signed certificate even when PFX settings are filled. (Issue #2118)

     Chores

    We updated the libraries and application dependencies to their latest versions to fix several vulnerabilities.

    We updated the application to Angular 21 which allowed us to remove some dependencies. (Issue #2127)

     Thank you

    A big thank you to the following people who helped to make Mockoon better:

    @rohanakode490: Command palette's recently used commands, header rules auto-completion, URL safe base64 helpers, string replace helpers, stringify helper improvements.

    GitHub release notice: Full changelog

    ⚠️ macOS builds are broken (see #2151). Use v9.6.1.

    Source: https://mockoon.com/releases/9.6.0/ Official release: https://github.com/mockoon/mockoon/releases/tag/v9.6.0