Self-hosted Retool stable releases - 2025
Release notes for all stable channel releases of Self-hosted Retool in 2025.
Retool releases a version on the stable channel each quarter. A stable release is generally four versions behind the cloud-hosted version at the time.
Preparation and testing of a stable version occurs approximately four weeks prior to its release. Stable releases are rigorously tested before they are published. As the release cycle is less frequent, administrators can more easily maintain and upgrade deployments.
Retool supports each stable release for six months. During this time, Retool will release patch updates that contain bug fixes or security updates. Patch updates do not contain functionality changes and can be applied more quickly than performing a full version upgrade.
Retool provides versioned product documentation for supported stable releases. When browsing Retool Docs, use the version dropdown menu in the navbar to switch to a relevant version.
After six months, a stable release is considered deprecated. You can continue using a deprecated release but it will no longer receive updates. At this time, you should upgrade to the latest stable release.
Release lines are grouped by the year of their initial release. Patch updates released in later years are included in the same section as the original release line.
Self-hosted Retool 3.300
Latest releaseCurrently supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.300.0 | Dec 3, 2025 | sha256:391b014af98400483bb27b9b80a1f4e63312ac6edd49285b1278f9d24044f077 |
| Latest | 3.300.29 | May 13, 2026 | sha256:05f6e43d48dc7b06e350c7f3a4090cf1d53f10cb2cddfcaee3f5b5eea784924f |
Subscribe to the Atom feed for 3.300 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| new | Assist supports Amazon Bedrock Assist supports Amazon Bedrock as a single model provider. |
| new | Claude Haiku 4.5 available in Retool Retool now supports Claude Haiku 4.5. |
| deprecated | Deprecated: Claude Sonnet 3.5 Retool no longer supports Claude Sonnet 3.5. |
| deprecated | Deprecated: GPT 3.5 Turbo Retool no longer supports GPT 3.5 Turbo. |
| deprecated | Deprecated: Llama 4 models Retool no longer supports Llama 4 Maverick. |
| new | General availability of Kafka, SQS, SNS, Tavily Tavily Web Search and all streaming integrations are now generally available. |
| new | Kimi K2 Instruct available in Retool Retool now supports Kimi K2 Instruct. |
| new | Multiple Secrets Manager configurations beta Self-hosted organizations can now create multiple Secrets Manger configurations and retrieve secrets from different locations. |
| new | Protected workflow triggers Retool now supports protecting workflow triggers. |
| new | Reorder pages in multipage apps Retool supports page reordering in multipage apps. |
| new | Resource type restrictions for self-hosted Retool Self-hosted organizations can prevent users from creating or using certain types of resources. |
| new | Retool API endpoint to retrieve IP address allowlist Use a Retool API endpoint to retrieve Retool's IP addresses. |
| new | Source Control available for Agents Protect agents with Source Control. |
| new | Updates and improvements to Assist Assist can generate READMEs and name apps. |
| 14 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.300.291 change↓ | |
| 3.300.281 change↓ | |
| 3.300.271 change↓ | |
| 3.300.261 change↓ | |
| 3.300.251 change↓ | |
| 3.300.231 change↓ | |
| 3.300.201 change↓ | |
| 3.300.191 change↓ | |
| 3.300.174 changes↓ | |
| 3.300.161 change↓ | |
| 3.300.152 changes↓ | |
| 3.300.143 changes↓ | |
| 3.300.136 changes↓ | |
| 3.300.121 change↓ | |
| 3.300.94 changes↓ | |
| 3.300.71 change↓ | |
| 3.300.61 change↓ | |
| 3.300.54 changes↓ | |
| 3.300.45 changes↓ | |
| 3.300.23 changes↓ | |
| 3.300.19 changes↓ | |
| 3.300.0113 changes↓ | |
| 165 changes | |
Self-hosted Retool 3.284
Currently supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.284.0 | Oct 21, 2025 | sha256:57c2b18ef790aca8ea4eaf16cf41e0e049cf1aa6e87ecd02781938883389508d |
| Latest | 3.284.30 | Apr 24, 2026 | sha256:6fb2a01501c40fa8e30208d509b86bdbc49e7c4a89034ae48867a1b83f7718f0 |
Subscribe to the Atom feed for 3.284 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| improved | Custom component support library update Retool updated the custom component support library to version 1.9.0, which adds a new verbose option with `deploy` and `sync` commands. |
| new | Databricks Lakebase integration Databricks Lakehouse integration is now available. |
| new | General availability of Fullstory integration Capture user app behavior for use with Fullstory. |
| new | General availability of internationalization Internationalization is now generally available |
| new | Multi-instance releases for Source Control Source Control multi-instance releases are now supported. |
| new | OAuth 2.0 available for MCP tools on Agents OAuth support for MCP agents is now available. |
| new | Performance monitoring available in public beta Use Retool's performance monitoring integration to send page load and query traces to Datadog or Sentry. |
| new | Public beta: Assist Use Assist to generate and edit apps with AI. |
| new | README improvements for apps The README is now included in the **Pages** list of the app IDE and can be generated automatically with AI. |
| removed | Removal of unsupported JDBC connectors Retool removed some JDBC connectors that were inadvertently included in certain self-hosted release versions. |
| improved | Restrict users from creating draft apps You can now restrict users from creating draft apps. |
| new | Result sync in Invoke Agent block Automate human work with AI. |
| new | Role-based permissions Granular admin permissions using role-based access control is now in beta. |
| new | Source Control available for Agents Protect agents with Source Control. |
| new | Support for branch merging with Source Control You can now integrate changes from your default branch from within the App IDE. |
| improved | Update to default user permissions on Business and Enterprise plans For new organizations, the **All Users** group has no permissions by default. |
| 16 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.284.301 change↓ | |
| 3.284.291 change↓ | |
| 3.284.241 change↓ | |
| 3.284.231 change↓ | |
| 3.284.222 changes↓ | |
| 3.284.212 changes↓ | |
| 3.284.203 changes↓ | |
| 3.284.162 changes↓ | |
| 3.284.152 changes↓ | |
| 3.284.141 change↓ | |
| 3.284.131 change↓ | |
| 3.284.121 change↓ | |
| 3.284.102 changes↓ | |
| 3.284.93 changes↓ | |
| 3.284.78 changes↓ | |
| 3.284.62 changes↓ | |
| 3.284.54 changes↓ | |
| 3.284.43 changes↓ | |
| 3.284.21 change↓ | |
| 3.284.11 change↓ | |
| 3.284.0115 changes↓ | |
| 157 changes | |
Self-hosted Retool 3.253
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.253.0 | Sep 9, 2025 | sha256:a8fc8b14e0fc71338a9d01d697eb3eb5c54e64119fa0d3edba73ebc3051a38db |
| Latest | 3.253.29 | Mar 12, 2026 | sha256:d078df571d43db29e775fd9a36e80ed7c51ff1591eb2b8109fb2636b5e7f3dc3 |
Subscribe to the Atom feed for 3.253 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| new | Access lists for workflows, resources, and agents View access lists for workflows, resources, and agents. |
| improved | Code executor changes in self-hosted 3.251 and later Code executor changes in self-hosted 3.251 and later require updating existing installations. |
| new | Data input typing for modules New data type validation improves the inputs for modules. |
| improved | Module layout updates New configuration options improve the layout of modules. |
| improved | Page UUIDs in Source Control Submit an empty commit in Source Control to support per-page permissions. |
| improved | Per-page view permissions for multipage apps Configure **Use** permissions for each page of a multipage app. |
| new | Protected workflows support manual releases Retool now supports versioning and releasing protected workflows. |
| new | Retool Agents Automate human work with AI. |
| new | Support for Bitbucket access tokens Retool now supports Bitbucket access tokens. |
| improved | Updates to workflow release language When your workflow is ready, you can publish a release. |
| 10 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.253.282 changes↓ | |
| 3.253.275 changes↓ | |
| 3.253.261 change↓ | |
| 3.253.242 changes↓ | |
| 3.253.231 change↓ | |
| 3.253.221 change↓ | |
| 3.253.211 change↓ | |
| 3.253.191 change↓ | |
| 3.253.181 change↓ | |
| 3.253.171 change↓ | |
| 3.253.153 changes↓ | |
| 3.253.141 change↓ | |
| 3.253.132 changes↓ | |
| 3.253.111 change↓ | |
| 3.253.91 change↓ | |
| 3.253.82 changes↓ | |
| 3.253.72 changes↓ | |
| 3.253.61 change↓ | |
| 3.253.51 change↓ | |
| 3.253.25 changes↓ | |
| 3.253.0155 changes↓ | |
| 190 changes | |
Self-hosted Retool 3.196
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.196.0 | May 12, 2025 | sha256:9e91e3c24eca2affd730ad4a2126b956945849e3e141d9afa8f06ed9f972148d |
| Latest | 3.196.33 | Nov 13, 2025 | sha256:1ab464c93254071da6d7118d9ddd8141642fa185016e1827b51edbd53c2ca21d |
Subscribe to the Atom feed for 3.196 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| new | A read/write NFC resource is now available for Retool Mobile A resource-based NFC integration for Retool Mobile now supports both reading and writing NFC tags. |
| improved | App page save compaction Retool made improvements to how app saves are stored, resulting in faster app load times. |
| improved | App-related Debug Tool improvements Debug Tools have been updated to improve performance and optimization debugging. |
| changed | Backend runtime upgraded to Node.js v20.18 in self-hosted Retool 3.163 The backend runtime in self-hosted Retool 3.163 and later uses Node.js v20.18. This may increase CPU and memory usage. |
| improved | Bulk component editing Retool supports editing two or more components at once. |
| improved | Changes to ToolScript file locations ToolScript positioning information is now organized by page. |
| improved | Closed beta for Retool Database UI improvements A redesigned Retool Database UI is in closed beta, with a clearer data view, faster navigation, and a new command bar. |
| improved | Custom URL paths for workflow webhook triggers You can now customize the URL of your workflow webhook trigger. |
| improved | Debug Tool searching Debug Tools now support searching. |
| removed | Deprecation of YAML serialization in Source Control Retool will deprecate the use of YAML for protected apps, queries, and resources self-hosted Retool 3.196 and later. |
| new | Disable catch-up commits in Source Control Retool added the ability to disable catch-up commits. |
| new | Error reporting for Retool Workflows Send workflow errors to Sentry and Datadog |
| improved | Improvements for exporting to modules An improved **Export to Module** feature. |
| improved | Improvements to Source Control for workflows Retool added support for new Source Control features on workflows, including branching, multi-element branches, and collaborative branches. |
| new | In-place conversion to multipage Easily convert single-page apps to multipage. |
| new | Multi-step functions Multi-step functions |
| new | New Offline Assets app setting and PDF Viewer component for Retool Mobile New PDF component and offline assets support for Retool Mobile. |
| new | New Retool Event for attempted login New Retool Event for attempted user login. |
| new | New test headers and path parameters for webhook triggers Test your webhook workflow triggers using test headers and test path parameters. |
| improved | NsJail no longer required for custom libraries NsJail is no longer required to use custom libraries in workflows on Self-hosted Retool. |
| new | Personal folder for draft apps Users now have a personal drafts folder in which they can create private apps. |
| new | Publish referenced workflows Automatically detect changes and publish referenced workflows. |
| new | Record user sessions with Fullstory Capture user app behavior for use with Fullstory. |
| improved | Retool AI queries support dynamic model selection Retool AI text queries now support dynamic model selection, allowing users to change AI models from apps and workflows. |
| new | Scanner component improvements in Retool Mobile An improved Scanner component for Retool Mobile is in closed beta, adding support for multiple barcode symbologies, scan modes, and visual scan feedback. |
| removed | Single-page apps can no longer be created All new web and mobile apps are multipage. |
| new | The App Inspector The App Inspector includes app-wide settings, such as custom URL, custom shortcuts, and max width. |
| improved | Updates to Slack connector to support file upload The Slack integration now uses new file upload APIs after Slack ended support for the files.upload endpoint on March 11, 2025. |
| improved | Updates to the Retool Apps landing page The Retool Apps landing page has an updated layout. |
| improved | Usage analytics improvements An improved usage analytics experience is now available. |
| improved | Workflow logging and debugging improvements A series of improvements to the logging and debugging capabilities of Retool Workflows. |
| 31 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.196.331 change↓ | |
| 3.196.322 changes↓ | |
| 3.196.234 changes↓ | |
| 3.196.191 change↓ | |
| 3.196.181 change↓ | |
| 3.196.162 changes↓ | |
| 3.196.141 change↓ | |
| 3.196.121 change↓ | |
| 3.196.111 change↓ | |
| 3.196.91 change↓ | |
| 3.196.74 changes↓ | |
| 3.196.53 changes↓ | |
| 3.196.45 changes↓ | |
| 3.196.32 changes↓ | |
| 3.196.21 change↓ | |
| 3.196.11 change↓ | |
| 3.196.0140 changes↓ | |
| 171 changes | |
Self-hosted Retool 3.148
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.148.23 | Jan 16, 2025 | sha256:cd36589962db14a59033858e0b704e474bfde0d2c6c55b7901a3ee7ea75f48fb |
| Latest | 3.148.32 | Aug 27, 2025 | sha256:d491cc7cd6210e545f2beeaf75dadb955c155eec943b3a7e56010ee9e0658917 |
Subscribe to the Atom feed for 3.148 to get notified when new patch releases are available.
Major changes in this release
New features, significant changes, and any actions required when upgrading.
| Type ↕ | Change ↑ |
|---|---|
| deprecated | Deprecation of Databricks connector version 1.0 Retool has deprecated version 1.0 of the Databricks connector. |
| new | Execution modes for Workflow blocks Workflow blocks now have several execution modes. |
| improved | Improvements to Source Control for workflows Retool added support for new Source Control features on workflows, including branching, multi-element branches, and collaborative branches. |
| improved | Improvements to the command palette The Command Palette includes several improvements related to frames and page navigation. |
| improved | Improvements to the Navigation component Improvements to the Navigation component |
| new | Multi-step functions Multi-step functions |
| new | New version of the Cascader component An updated Cascader component is now available for use in Retool apps. |
| improved | OpenAI o1 available in Retool AI OpenAI o1 available in Retool AI |
| improved | Retool apps now support multiple pages by default Multipage apps |
| improved | Support for shadows in app themes Shadow styling is now available in app-level and organization-level themes. |
| improved | Test deployments for Source Control Test deployments for Source Control |
| new | Wait blocks You can now add a Wait block to a workflow. |
| 12 changes | |
Patch release notes
Bug fixes, improvements, and other incremental updates across all patch releases in this release.
| Type | Description |
|---|---|
| 3.148.301 change↓ | |
| 3.148.291 change↓ | |
| 3.148.272 changes↓ | |
| 3.148.152 changes↓ | |
| 3.148.142 changes↓ | |
| 3.148.133 changes↓ | |
| 3.148.122 changes↓ | |
| 3.148.112 changes↓ | |
| 3.148.102 changes↓ | |
| 3.148.91 change↓ | |
| 3.148.81 change↓ | |
| 3.148.72 changes↓ | |
| 3.148.61 change↓ | |
| 3.148.52 changes↓ | |
| 3.148.41 change↓ | |
| 3.148.32 changes↓ | |
| 3.148.22 changes↓ | |
| 3.148.077 changes↓ | |
| 3.148.232 changes↓ | |
| 108 changes | |