Skip to main content

​
Distribution

This page explains the difference between Cube Core and Cube Cloud, provides links to ready-to-use artifacts, and explains the versioning model and the release cycle, including the long-term support (LTS).

​
Cube Core and Cube Cloud

Cube Core is the universal semantic layer, developed by Cube Dev and the community in open source under a permissive Apache License 2.0. You can find its source code on GitHub. Cube Cloud is the managed platform for Cube Core, developed by Cube Dev as a commercial product. It includes everything from Cube Core and provides additional semantic layer features, managed infrastructure and workspace tools. Cube can be used to refer to both products if the distinction is not important in a particular case.
All Cube Cloud-specific features are marked with similar green boxes throughout this documentation.
You are welcome to either sign up for Cube Cloud and start using it for free. You can also self-host a Cube Core deployment.

​
Artifacts

Cube Core is packaged and distributed as Docker images that you can run in a containerized environment. You can find images for Cube and Cube Store on Docker Hub. Note that Cube Store images support the linux/amd64 architecture while Cube images support both linux/amd64 and linux/arm64. The latter is convenient for Mac computers with Apple silicon that you might use to run Cube locally. Notably, the following tags are used with Docker images:
  • v1.1.0 and similar, one tag per each released version.
  • latest, always pointing to the latest release.
  • dev, always pointing to the bleeding-edge image built for the latest commit.

​
Versions

Cube is actively developed, and new versions are released frequently. Versions mostly follow SemVer principles, with the only exception that breaking changes can happen both in major and minor versions. Before upgrading, it is recommended that you check the release notes on GitHub and read changelog entries in the blog.
You can find a list of currently deprecated features on GitHub. Usually, there are also deprecation notices in the documentation that look similar to this one.
Additionally, Cube Cloud provides LTS or Regular update channels.

​
Long-term support

To provide guarantees for the long-term support of Cube Core, some minor releases are designated as long-term support (LTS) releases.
Check the long-term support announcement in the blog.
For 12 months after being marked as LTS, these releases receive fixes for defects that significantly impact stability and functionality as well as the security fixes for critical vulnerabilities. It is recommended to use the latest patch version within an LTS release. List of LTS releases:
VersionStatusEnd-of-life date
v1.4.xActiveOctober 29, 2026
v1.0.xEnd-of-lifeOctober 29, 2025

​
Documentation

The documentation at cube.dev/docs always reflects the latest released version. To obtain the documentation for a specific version: 
git clone --depth 1 --branch v1.5.0 https://github.com/cube-js/cube.git
cd cube/docs
yarn && yarn dev
open http://localhost:3000