|
| 1 | +# Distribution |
| 2 | + |
| 3 | +This page explains the difference between [Cube Core and Cube Cloud](#cube-core-and-cube-cloud), |
| 4 | +provides links to ready-to-use [artifacts](#artifacts), and explains the |
| 5 | +[versioning model](#versions) and the release cycle, including the [long-term |
| 6 | +support](#long-term-support) (LTS). |
| 7 | + |
| 8 | +## Cube Core and Cube Cloud |
| 9 | + |
| 10 | +_Cube Core_ is the universal semantic layer, developed by [Cube Dev][link-company] |
| 11 | +and the community in open source under a permissive [Apache License 2.0][link-license]. |
| 12 | +You can find its [source code][link-repo] on GitHub. |
| 13 | + |
| 14 | +_Cube Cloud_ is the managed platform for Cube Core, developed by Cube Dev as a |
| 15 | +[commercial product][link-pricing]. It includes everything from Cube Core and |
| 16 | +provides additional semantic layer features, [managed infrastructure][ref-infrastructure] |
| 17 | +and [workspace tools][ref-workspace]. |
| 18 | + |
| 19 | +_Cube_ can be used to refer to both products if the distinction is not important |
| 20 | +in a particular case. |
| 21 | + |
| 22 | +<SuccessBox> |
| 23 | + |
| 24 | +All Cube Cloud-specific features are marked with similar green boxes throughout |
| 25 | +this documentation. |
| 26 | + |
| 27 | +</SuccessBox> |
| 28 | + |
| 29 | +You are welcome to either [sign up for Cube Cloud][link-sign-up] or |
| 30 | +[self-host][ref-deployment] a Cube Core deployment. |
| 31 | + |
| 32 | +## Artifacts |
| 33 | + |
| 34 | +Cube Core is packaged and distributed as Docker images that you can run in a |
| 35 | +containerized environment. You can find images for [Cube][link-dockerhub-cube] |
| 36 | +and [Cube Store][link-dockerhub-cubestore] on Docker Hub. |
| 37 | + |
| 38 | +Note that Cube Store images support the `linux/amd64` architecture while Cube |
| 39 | +images support both `linux/amd64` and `linux/arm64`. The latter is convenient for |
| 40 | +Mac computers with [Apple silicon][link-apple-silicon] that you might use to run |
| 41 | +Cube locally. |
| 42 | + |
| 43 | +Notably, the following tags are used with Docker images: |
| 44 | +- `v1.1.0` and similar, one tag per each released version. |
| 45 | +- `latest`, always pointing to the latest release. |
| 46 | +- `dev`, always pointing to the bleeding-edge image built for the latest commit. |
| 47 | + |
| 48 | +## Versions |
| 49 | + |
| 50 | +Cube is actively developed, and new versions are released frequently. |
| 51 | + |
| 52 | +Versions mostly follow [SemVer][link-semver] principles, with the only exception |
| 53 | +that breaking changes can happen both in _major_ and _minor_ versions. Before |
| 54 | +upgrading, it is recommended that you check the [release notes][link-releases] |
| 55 | +on GitHub and read [changelog entries][link-changelog] in the blog. |
| 56 | + |
| 57 | +Additionally, Cube Cloud provides [update channels][ref-update-channels] where |
| 58 | +versions are marked as either <Btn>Stable</Btn> or <Btn>Latest</Btn>. |
| 59 | + |
| 60 | +### Long-term support |
| 61 | + |
| 62 | +To provide guarantees for the long-term support of Cube Core, some minor releases |
| 63 | +are designated as _long-term support (LTS) releases_. |
| 64 | + |
| 65 | +<InfoBox> |
| 66 | + |
| 67 | +Check the [long-term support announcement][link-lts-accouncement] in the blog. |
| 68 | + |
| 69 | +</InfoBox> |
| 70 | + |
| 71 | +For 12 months after being marked as LTS, these releases receive fixes for defects |
| 72 | +that significantly impact stability and functionality as well as the security |
| 73 | +fixes for critical vulnerabilities. It is recommended to use the latest patch |
| 74 | +version within an LTS release. |
| 75 | + |
| 76 | +List of LTS releases: |
| 77 | + |
| 78 | +| Version | Status | End-of-life date | |
| 79 | +| --- | --- | --- | |
| 80 | +| `v1.0.x` | Active | October 29, 2025 | |
| 81 | + |
| 82 | + |
| 83 | +[link-repo]: https://github.com/cube-js/cube |
| 84 | +[link-license]: https://github.com/cube-js/cube/blob/master/LICENSE |
| 85 | +[link-releases]: https://github.com/cube-js/cube/releases |
| 86 | +[link-company]: https://cube.dev/about |
| 87 | +[link-pricing]: https://cube.dev/pricing |
| 88 | +[link-sign-up]: https://cubecloud.dev/auth/signup |
| 89 | +[link-changelog]: https://cube.dev/blog/category/changelog |
| 90 | +[link-lts-accouncement]: https://cube.dev/blog/introducing-long-term-support-lts-for-cube-core |
| 91 | +[link-dockerhub-cube]: https://hub.docker.com/r/cubejs/cube/tags |
| 92 | +[link-dockerhub-cubestore]: https://hub.docker.com/r/cubejs/cubestore/tags |
| 93 | +[link-apple-silicon]: https://support.apple.com/en-us/116943 |
| 94 | +[link-semver]: https://semver.org |
| 95 | +[ref-infrastructure]: /product/deployment/cloud |
| 96 | +[ref-workspace]: /product/workspace |
| 97 | +[ref-deployment]: /product/deployment |
| 98 | +[ref-update-channels]: /product/deployment/cloud/deployments#update-channels |
0 commit comments