Skip to content

docs: document supported architectures #7532

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
puneetdixit200 wants to merge 2 commits into
base: master
Choose a base branch
from
+35 −0
Open

docs: document supported architectures #7532

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
9a0b1e9
docs: document supported architectures
puneetdixit200 May 20, 2026
e0a509a
docs: clarify supported architecture testing
May 21, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 35 additions & 0 deletions docs/guides/supported-architectures.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
---
title: "Supported architectures"
linkTitle: "Supported architectures"
weight: 16
---

Cortex release artifacts are built for the operating systems and architectures
listed below. Use these targets when selecting container images, binary
artifacts, or OS packages for production deployments.

## Supported release targets

| Artifact type | Operating system | Architectures |
|---------------|------------------|---------------|
| Container images | Linux | `amd64`, `arm64` |
| Cortex binary | Linux | `amd64`, `arm64` |
| Cortex binary | darwin (macOS) | `amd64`, `arm64` |
| `query-tee` binary | Linux | `amd64`, `arm64` |
| `query-tee` binary | darwin (macOS) | `amd64`, `arm64` |
| Debian package | Linux | `amd64`, `arm64` |
| RPM package | Linux | `amd64`, `arm64` |

The CI and release pipelines build Cortex with `GOOS` and `GOARCH` targets
matching these rows. Automated tests run against Linux `amd64` and `arm64`
Cortex images.

## Unsupported targets

Other operating systems or architectures may work when built from source, but
they are not part of the regular Cortex release artifacts or CI matrix. Treat
those builds as unsupported unless you validate them in your own environment.

Cortex does not require architecture-specific CPU extensions such as AVX in its
release build configuration. If you use external services or custom base images
alongside Cortex, verify their architecture and CPU requirements separately.
Loading