^..^
 ( oo )  oinc ~ OKD in a container
  (..)

MicroShift under the hood, with Console, OLM, and ConsolePlugin CRD out of the box.

oinc create

That's it. You get a single-node cluster with the OpenShift Console on localhost:9000, OLM running, and the ConsolePlugin CRD available -- close enough to real OCP for local dev work.

• Auto-detects container runtime (docker, podman) -- no flags needed
• Version switching -- oinc create --version 4.20 to target a specific OCP release
• Console included -- OpenShift Console runs as a sidecar, no separate setup
• OLM included -- baked into the image, operator workflows work out of the box
• Addon system -- layer on Gateway API, cert-manager, MetalLB, Istio, Kuadrant as needed
• Console plugin support -- --console-plugin "my-plugin=http://localhost:9001" for plugin dev
• Interactive TUI -- step-by-step progress with spinners, interactive addon picker, live status dashboard

Download a binary from releases:

# macOS (Apple Silicon)
curl -L https://github.com/jasonmadigan/oinc/releases/latest/download/oinc-darwin-arm64 -o oinc
chmod +x oinc && sudo mv oinc /usr/local/bin/

# macOS (Intel)
curl -L https://github.com/jasonmadigan/oinc/releases/latest/download/oinc-darwin-amd64 -o oinc
chmod +x oinc && sudo mv oinc /usr/local/bin/

# Linux (amd64)
curl -L https://github.com/jasonmadigan/oinc/releases/latest/download/oinc-linux-amd64 -o oinc
chmod +x oinc && sudo mv oinc /usr/local/bin/

Or with Go:

go install github.com/jasonmadigan/oinc/cmd/oinc@latest

# create cluster (latest OCP version, auto-detect runtime)
oinc create

# create with a specific version
oinc create --version 4.20

# create with addons
oinc create --addons gateway-api,cert-manager

# addon version pinning
oinc create --addons cert-manager@1.16.0,metallb@0.14.8

# wire in a console plugin dev server
oinc create --console-plugin "my-plugin=http://host.docker.internal:9001"

# cluster status
oinc status

# interactive status dashboard
oinc status --watch

# fetch/refresh kubeconfig
oinc kubeconfig

# switch OCP version (delete + create)
oinc switch 4.20

# list available versions
oinc version list

# tear down
oinc delete

Commands show styled progress in a terminal (spinners, checkmarks, boxed output) and fall back to plain log output when piped or in CI.

• oinc create -- step-by-step progress with a summary of endpoints on completion
• oinc delete -- confirmation prompt (skip with --force)
• oinc status -- boxed endpoint and addon status; --watch for a live-updating dashboard with pod listing
• oinc addon install -- interactive picker when run with no arguments; shows installed addons as checked
• oinc addon install kuadrant -- step progress with live sub-status per addon
• oinc status -o json -- machine-readable output for scripting

The base cluster includes MicroShift + OLM + Console + ConsolePlugin CRD. Addons layer extra infrastructure on top:

Dependencies are resolved automatically. Installing kuadrant will pull in gateway-api, cert-manager, metallb, and istio.

# at create time
oinc create --addons kuadrant

# or post-hoc (interactive picker)
oinc addon install

# or specify directly
oinc addon install gateway-api
oinc addon list

Pin addon versions with @:

oinc addon install cert-manager@1.16.0

oinc create automatically merges the cluster kubeconfig into ~/.kube/config with context name oinc. If you need to refresh it:

# merge into ~/.kube/config
oinc kubeconfig

# print raw kubeconfig to stdout
oinc kubeconfig --print

# switch to oinc context
kubectl config use-context oinc

• Docker or Podman
• ~4GB RAM available for the container
• curl (for fetching upstream manifests and CRDs)
• kubectl (for cert-manager and metallb addons)
• helm (for istio and kuadrant addons)

oinc builds on the work of several projects:

• MicroShift -- the lightweight OpenShift runtime that powers the cluster
• microshift-io -- OKD-flavoured MicroShift builds and pre-built RPMs
• OKD -- the community distribution of Kubernetes that powers OpenShift
• OpenShift Console -- the web UI
• minc -- inspiration for running MicroShift in a container