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.
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.
note
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
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.300.0 | Dec 3, 2025 | sha256:391b014af98400483bb27b9b80a1f4e63312ac6edd49285b1278f9d24044f077 |
| Latest | 3.300.34 | Jul 20, 2026 | sha256:67c9e88cb5f31078bd43aafd4719cd5d40cbd9ef10abf7dea2c10b58fd8bb4a6 |
Best practice
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 | Kimi K2 Instruct available in Retool Retool now supports Kimi K2 Instruct. |
| new | Resource type restrictions for self-hosted Retool Self-hosted organizations can prevent users from creating or using certain types of resources. |
| new | Multiple Secrets Manager configurations beta Self-hosted organizations can now create multiple Secrets Manger configurations and retrieve secrets from different locations. |
| new | Retool API endpoint to retrieve IP address allowlist Use a Retool API endpoint to retrieve Retool's IP addresses. |
| new | Reorder pages in multipage apps Retool supports page reordering in multipage apps. |
| new | Protected workflow triggers Retool now supports protecting workflow triggers. |
| new | Claude Haiku 4.5 available in Retool Retool now supports Claude Haiku 4.5. |
| new | Source Control available for Agents Protect agents with Source Control. |
| new | Updates and improvements to Assist Assist can generate READMEs and name apps. |
| new | Assist supports Amazon Bedrock Assist supports Amazon Bedrock as a single model provider. |
| new | General availability of Kafka, SQS, SNS, Tavily Tavily Web Search and all streaming integrations are now generally available. |
| deprecated | Deprecated: Llama 4 models Retool no longer supports Llama 4 Maverick. |
| deprecated | Deprecated: GPT 3.5 Turbo Retool no longer supports GPT 3.5 Turbo. |
| deprecated | Deprecated: Claude Sonnet 3.5 Retool no longer supports Claude Sonnet 3.5. |
| 14 changes | |
Patch release notes
Bug fixes, improvements, and changes across all patch versions in this release.
| Type ↑ | Description ↕ |
|---|---|
| 3.300.71 change↓ | |
| 3.300.19 changes↓ | |
| 3.300.0113 changes↓ | |
| 3.300.334 changes↓ | |
| 3.300.311 change↓ | |
| 3.300.281 change↓ | |
| 3.300.201 change↓ | |
| 3.300.191 change↓ | |
| 3.300.174 changes↓ | |
| 3.300.161 change↓ | |
| 3.300.143 changes↓ | |
| 3.300.136 changes↓ | |
| 3.300.121 change↓ | |
| 3.300.54 changes↓ | |
| 3.300.45 changes↓ | |
| 3.300.23 changes↓ | |
| 3.300.152 changes↓ | |
| 3.300.341 change↓ | |
| 3.300.321 change↓ | |
| 3.300.301 change↓ | |
| 3.300.291 change↓ | |
| 3.300.271 change↓ | |
| 3.300.261 change↓ | |
| 3.300.251 change↓ | |
| 3.300.231 change↓ | |
| 3.300.94 changes↓ | |
| 3.300.61 change↓ | |
| 173 changes | |
Self-hosted Retool 3.284
No longer supported
| Release | Released | Digest | |
|---|---|---|---|
| First | 3.284.0 | Oct 21, 2025 | sha256:57c2b18ef790aca8ea4eaf16cf41e0e049cf1aa6e87ecd02781938883389508d |
| Latest | 3.284.30 | Apr 24, 2026 | sha256:6fb2a01501c40fa8e30208d509b86bdbc49e7c4a89034ae48867a1b83f7718f0 |
Best practice
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 ↕ |
|---|---|
| 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. |
| 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. |
| new | Multi-instance releases for Source Control Source Control multi-instance releases are now supported. |
| new | Databricks Lakebase integration Databricks Lakehouse integration is now available. |
| new | OAuth 2.0 available for MCP tools on Agents OAuth support for MCP agents is now available. |
| new | Role-based permissions Granular admin permissions using role-based access control is now in beta. |
| new | General availability of internationalization Internationalization is now generally 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 | General availability of Fullstory integration Capture user app behavior for use with Fullstory. |
| new | Result sync in Invoke Agent block Automate human work with AI. |
| 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. |
| improved | Restrict users from creating draft apps You can now restrict users from creating draft apps. |
| improved | Update to default user permissions on Business and Enterprise plans For new organizations, the **All Users** group has no permissions by default. |
| removed | Removal of unsupported JDBC connectors Retool removed some JDBC connectors that were inadvertently included in certain self-hosted release versions. |
| 16 changes | |
Patch release notes
Bug fixes, improvements, and changes across all patch versions in this release.
| Type ↑ | Description ↕ |
|---|---|
| 3.284.152 changes↓ | |
| 3.284.62 changes↓ | |
| 3.284.11 change↓ | |
| 3.284.212 changes↓ | |
| 3.284.203 changes↓ | |
| 3.284.121 change↓ | |
| 3.284.78 changes↓ | |
| 3.284.21 change↓ | |
| 3.284.0115 changes↓ | |
| 3.284.241 change↓ | |
| 3.284.93 changes↓ | |
| 3.284.43 changes↓ | |
| 3.284.231 change↓ | |
| 3.284.222 changes↓ | |
| 3.284.54 changes↓ | |
| 3.284.301 change↓ | |
| 3.284.291 change↓ | |
| 3.284.162 changes↓ | |
| 3.284.141 change↓ | |
| 3.284.131 change↓ | |
| 3.284.102 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 |
Best practice
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 | Retool Agents Automate human work with AI. |
| new | Support for Bitbucket access tokens Retool now supports Bitbucket access tokens. |
| new | Protected workflows support manual releases Retool now supports versioning and releasing protected workflows. |
| new | Access lists for workflows, resources, and agents View access lists for workflows, resources, and agents. |
| new | Data input typing for modules New data type validation improves the inputs for modules. |
| 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. |
| improved | Updates to workflow release language When your workflow is ready, you can publish a release. |
| improved | Per-page view permissions for multipage apps Configure **Use** permissions for each page of a multipage app. |
| improved | Page UUIDs in Source Control Submit an empty commit in Source Control to support per-page permissions. |
| improved | Module layout updates New configuration options improve the layout of modules. |
| 10 changes | |
Patch release notes
Bug fixes, improvements, and changes across all patch versions in this release.
| Type ↑ | Description ↕ |
|---|---|
| 3.253.261 change↓ | |
| 3.253.231 change↓ | |
| 3.253.141 change↓ | |
| 3.253.91 change↓ | |
| 3.253.61 change↓ | |
| 3.253.25 changes↓ | |
| 3.253.0155 changes↓ | |
| 3.253.275 changes↓ | |
| 3.253.191 change↓ | |
| 3.253.132 changes↓ | |
| 3.253.111 change↓ | |
| 3.253.82 changes↓ | |
| 3.253.72 changes↓ | |
| 3.253.153 changes↓ | |
| 3.253.282 changes↓ | |
| 3.253.51 change↓ | |
| 3.253.171 change↓ | |
| 3.253.242 changes↓ | |
| 3.253.221 change↓ | |
| 3.253.211 change↓ | |
| 3.253.181 change↓ | |
| 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 |
Best practice
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 | In-place conversion to multipage Easily convert single-page apps to multipage. |
| new | Record user sessions with Fullstory Capture user app behavior for use with Fullstory. |
| new | Disable catch-up commits in Source Control Retool added the ability to disable catch-up commits. |
| new | Multi-step functions Multi-step functions |
| new | Error reporting for Retool Workflows Send workflow errors to Sentry and Datadog |
| new | New test headers and path parameters for webhook triggers Test your webhook workflow triggers using test headers and test path parameters. |
| new | Publish referenced workflows Automatically detect changes and publish referenced workflows. |
| new | New Offline Assets app setting and PDF Viewer component for Retool Mobile New PDF component and offline assets support for Retool Mobile. |
| 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. |
| new | New Retool Event for attempted login New Retool Event for attempted user login. |
| 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. |
| new | The App Inspector The App Inspector includes app-wide settings, such as custom URL, custom shortcuts, and max width. |
| new | Personal folder for draft apps Users now have a personal drafts folder in which they can create private apps. |
| 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 for exporting to modules An improved **Export to Module** feature. |
| improved | Workflow logging and debugging improvements A series of improvements to the logging and debugging capabilities of Retool Workflows. |
| improved | NsJail no longer required for custom libraries NsJail is no longer required to use custom libraries in workflows on Self-hosted Retool. |
| improved | Debug Tool searching Debug Tools now support searching. |
| improved | Custom URL paths for workflow webhook triggers You can now customize the URL of your workflow webhook trigger. |
| improved | App page save compaction Retool made improvements to how app saves are stored, resulting in faster app load times. |
| improved | Bulk component editing Retool supports editing two or more components at once. |
| 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 | Usage analytics improvements An improved usage analytics experience is now available. |
| 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 | 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. |
| improved | Changes to ToolScript file locations ToolScript positioning information is now organized by page. |
| improved | App-related Debug Tool improvements Debug Tools have been updated to improve performance and optimization debugging. |
| improved | Updates to the Retool Apps landing page The Retool Apps landing page has an updated layout. |
| 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. |
| removed | Single-page apps can no longer be created All new web and mobile apps are multipage. |
| 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. |
| 31 changes | |
Patch release notes
Bug fixes, improvements, and changes across all patch versions in this release.
| Type ↑ | Description ↕ |
|---|---|
| 3.196.331 change↓ | |
| 3.196.162 changes↓ | |
| 3.196.32 changes↓ | |
| 3.196.0140 changes↓ | |
| 3.196.322 changes↓ | |
| 3.196.234 changes↓ | |
| 3.196.191 change↓ | |
| 3.196.141 change↓ | |
| 3.196.121 change↓ | |
| 3.196.111 change↓ | |
| 3.196.91 change↓ | |
| 3.196.53 changes↓ | |
| 3.196.45 changes↓ | |
| 3.196.11 change↓ | |
| 3.196.74 changes↓ | |
| 3.196.181 change↓ | |
| 3.196.21 change↓ | |
| 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 |
Best practice
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 ↕ |
|---|---|
| new | Multi-step functions Multi-step functions |
| new | Wait blocks You can now add a Wait block to a workflow. |
| new | Execution modes for Workflow blocks Workflow blocks now have several execution modes. |
| new | New version of the Cascader component An updated Cascader component is now available for use in Retool apps. |
| 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 | Support for shadows in app themes Shadow styling is now available in app-level and organization-level themes. |
| 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 | Test deployments for Source Control Test deployments for Source Control |
| improved | Improvements to the Navigation component Improvements to the Navigation component |
| deprecated | Deprecation of Databricks connector version 1.0 Retool has deprecated version 1.0 of the Databricks connector. |
| 12 changes | |
Patch release notes
Bug fixes, improvements, and changes across all patch versions in this release.
| Type ↑ | Description ↕ |
|---|---|
| 3.148.272 changes↓ | |
| 3.148.133 changes↓ | |
| 3.148.112 changes↓ | |
| 3.148.22 changes↓ | |
| 3.148.077 changes↓ | |
| 3.148.301 change↓ | |
| 3.148.152 changes↓ | |
| 3.148.102 changes↓ | |
| 3.148.72 changes↓ | |
| 3.148.52 changes↓ | |
| 3.148.41 change↓ | |
| 3.148.232 changes↓ | |
| 3.148.61 change↓ | |
| 3.148.291 change↓ | |
| 3.148.122 changes↓ | |
| 3.148.91 change↓ | |
| 3.148.81 change↓ | |
| 3.148.32 changes↓ | |
| 3.148.142 changes↓ | |
| 108 changes | |