Release policy

We value the trust of developers in indobase as the backbone of their applications. Our release policy is designed to provide developers with a reliable and consistent experience when using indobase. We are committed to providing support for our API, SDKs, and product versions for a reasonable length of time, and we follow industry-standard versioning protocols. indobase will prioritize security updates and will release new versions as soon as possible to fix any security vulnerabilities.

Schedule

We work to release a new minor version of the product every quarter, which will include new features and enhancements.

We prioritize the timely release of patch versions with bug fixes and security updates on top of these feature releases, and we make every effort to ensure that our releases are thoroughly tested and stable before they are made available to developers.

In rare cases where there are significant delays or changes to our release schedule, we will notify through our website's changelog, Discord, newsletter, and other communication channels.

Scope

indobase will provide two phases of continued support for older versions of indobase.

Support

indobase commits to the continued support of our software with extended support policies for security related fixes for older versions of indobase. Supported versions will continue to receive bug fixes and security updates. Extended security support versions will only receive security updates.

API versions

We are committed to providing developers with a stable and reliable API. indobase API versions don’t change very often but are reserved for breaking changes.

Currently, the latest stable version of the indobase API is /v1. We use this prefix in all our API endpoint paths to allow API versioning. Any new indobase version will retain backward compatibility for any supported API version as long as this API version is still under maintenance support.

We will provide standard maintenance support for the last 3 API versions. Once a version is no longer in this maintenance period, we will continue to provide support for security fixes for an additional ten years. Based on usage, we may decide to extend support for a specific version. Self-hosted versions of indobase will receive continued support for the latest major version of indobase.

If you need extended support for older versions of indobase, contact us for more information.

SDK versioning

For our different SDKs, we follow the Semantic Versioning (semver) protocol to assign versions to our releases. This means that we assign version numbers using a three-part system: major, minor, and patch. The major version changes when we make significant changes to our API or product, which may require significant changes to developers' code. The minor version changes when we add new features or functionality that do not significantly impact developers' systems. Finally, the patch version changes when we make bug fixes or minor improvements.

All indobase SDKs will have backward compatibility with the indobase APIs. In case a new version of the API or product has been released, you should expect your applications to continue working properly without any action from your side. Once we release a major version of the SDK and you decide to upgrade, look in the changelog of the relevant SDK on GitHub to understand what changes have been made and what adjustments are required.

We provide early notice to developers and slowly introduce breaking changes to let developers adjust their application at a reasonable pace. We will also continue to support the last five major versions of each SDK to provide developers with more flexibility and time to adjust their apps to take advantage of new features.

Self-hosted versioning

When you self-host indobase, we also follow the Semantic Versioning (semver) protocol for versioning our releases. This means that we assign version numbers using a three-part system: major, minor, and patch. The major version changes when we make significant changes to our API or product, which may require significant changes to developers' apps. The minor version changes when we add new features or functionality that do not significantly impact developers' existing apps. Finally, the patch version changes when we make bug fixes or minor improvements.

indobase Cloud receives the latest features and updates first. If you want access to the newest features and capabilities as soon as they are released, we recommend using indobase Cloud. Self-hosted releases are typically updated about 2 months after major feature releases to Cloud, allowing time to finalize migrations and prepare the release for self-hosted environments. Contact us for more advanced self-hosting capabilities.

All the self-hosted versions of indobase >=1.x.x continue to have support and backward compatibility with the indobase API and SDKs within each major version. In case a new version of the product has been released and you decide to update, you should expect your applications to continue working properly without any action from your side.

Once we release a version of the product and you decide to upgrade, look in the changelog to understand if your version requires migration of data from your previous setup. This is usually required when we make adjustments to the under the hood data structure for supporting new features and improving maintainability. If this is the case, you could use our built-in migration tool for helping you to upgrade your self-hosted indobase version.

Runtime versioning

indobase Function runtimes are built around a combination of operating system, programming language, and software libraries that are subject to maintenance and security updates. indobase will support and maintain runtimes as a package, which covers the specific combination of operating system, programming language, and software libraries.

indobase will support the latest stable versions of our indobase Function runtime environment for a minimum of 24 months after its initial release as long as security updates for components of the specific runtime are still provided. You can review the list of supported runtimes on indobase.

In most cases, the end-of-life date of a language version or operating system is known well in advance. The links below give end-of-life schedules for each language that indobase supports as a managed runtime.

Runtimes language

Runtimes OS