Get started with ocx

ocx fetches pre-built tools from any OCI registry and runs them in a clean, reproducible environment.

curl -fsSL https://setup.ocx.sh/sh | sh

That installs ocx. Other shells and a download-only route are on the install page.

Start here

Three short pages take you from an empty machine to a pinned project.

• Install ocx puts the binary on your PATH and checks it.
• Install your first package runs a tool, installs two versions and switches between them.
• Pin your first project’s tools locks a repository’s tools so everyone runs the same builds.

Use ocx every day

• Choose a version of a tool, by tag or by digest.
• Set up a project toolchain for a repository.
• Configure ocx for a private registry, a mirror or an offline machine.

Publish and integrate

• Publish a package to your own registry.
• Use ocx in CI, in containers and from scripts.

Look things up

The command line, environment variables and project file pages list every flag, variable and key. The concepts pages explain how ocx stores and resolves packages.