Skip to content

Commit 1c44cdb

Browse files
committed
docs: Distribution page + LTS releases list
1 parent c17a108 commit 1c44cdb

File tree

2 files changed

+99
-0
lines changed

2 files changed

+99
-0
lines changed

docs/pages/product/_meta.js

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,5 +8,6 @@ module.exports = {
88
"apis-integrations": "APIs & integrations",
99
"workspace": "Workspace",
1010
"deployment": "Deployment",
11+
"distribution": "Distribution",
1112
"faqs": "FAQs"
1213
}
Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
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

Comments
 (0)