Automated downloads | Open Cluster Scheduler

Pin an exact version

Use this for reproducible builds. The URL never changes meaning.

curl -fLO https://open.clusterscheduler.io/download/ocs-9.1.5/ocs-9.1.5-bin-lx-amd64.tar.gz

Follow the current release

/latest/ resolves to the newest stable release. It never resolves to a nightly or a pre-release, so a beta cannot reach your pipeline by surprise. Use -J so the file is saved under its full versioned name.

curl -fOJL https://open.clusterscheduler.io/latest/bin-lx-amd64.tar.gz
# saves ocs-9.1.5-bin-lx-amd64.tar.gz

Resolve, download, verify

/latest/version returns a bare version string as plain text, so no JSON parser is needed.

VER=$(curl -fsSL https://open.clusterscheduler.io/latest/version)
curl -fLO "https://open.clusterscheduler.io/download/ocs-${VER}/ocs-${VER}-bin-lx-amd64.tar.gz"
curl -fsSL "https://open.clusterscheduler.io/latest/md5sum.txt" | md5sum -c --ignore-missing

Check before downloading

Every download route answers HEAD. The response carries the resolved version and size without transferring the archive.

curl -fsIL https://open.clusterscheduler.io/latest/bundle-everything.tar.gz | grep -i 'x-ocs-\|content-length'

Nightly builds

Built from the development branch. Expect breakage; do not use on a production cluster.

curl -fOJL https://open.clusterscheduler.io/nightly/bin-lx-amd64.tar.gz
curl -fsSL https://open.clusterscheduler.io/nightly/version

Discovery API

Endpoint	Returns
GET /api/versions	Every published version with dates and categories
GET /api/latest	The current stable release and its artifacts
GET /api/packages	The full catalogue
GET /latest/version	Bare version string, `text/plain`
GET /nightly/version	Bare nightly version string

Artifact names

An artifact identifier is the filename with the ocs-<version>- prefix removed.

Identifier	Contents
bin-lx-amd64.tar.gz	Linux x86-64 binaries
bin-lx-arm64.tar.gz	Linux ARM64 binaries
bin-lx-riscv64.tar.gz	Linux RISC-V binaries
common.tar.gz	Shared files, required alongside any binary package
doc.tar.gz	Documentation and manual pages
bundle-everything.tar.gz	All platforms and components in one archive
md5sum.txt	Checksums for the release

Rate limits

30 downloads and 60 API calls per minute, per client. A nightly job pulling every platform is well inside that. Responses carry X-RateLimit-Remaining; a throttled request returns 429 with Retry-After.