CRC is a tool to help you run containers. It manages a local OpenShift 4.x cluster, Microshift or a Podman VM optimized for testing and development purposes
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.35.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
3956e856 cut v4.15.10 769abdbc Update microshift version to 4.15.9 a5761b0a Update OpenShift version to 4.15.10 (latest channel) d6d57501 [qe] change the httpd image used within e2e to registry.access.redhat.com/ubi8/httpd-24:latest ded1b1c7 [qe] fix integration image scripts 1b075edd [qe] Use ubi8 image as builder for qe images ec971124 telemetry: add no-op functionality ff8c9765 Chocolatey: Update project url for crc spec e25a6599 [qe] fix check for condition for a starting cluster behind proxy ec6cbfb3 build(deps): bump github.com/Microsoft/go-winio from 0.6.1 to 0.6.2 c1889941 [qe] improve windows pr-checks / merges running integration, e2e in parallel ae4e57fe [qe] refactor qe images to make use of deliverest base image c948c26a build(deps): bump github.com/onsi/gomega from 1.32.0 to 1.33.0 52381431 cert_renewal: fix incorrect info for wait time in log info 0fe2275e Integration: Fix marketplace test using workaround 948ff297 cert_renewal: Increase waiting time from 8min to 10min 1db4f266 cert_renewal: Watch kubelet-serving signer along with kube-apiserver-client-kubelet f38564f7 cert_removal: Remove code path which is fixed in later version of OCP 52636900 Test changes for podman preset removal 8f83eae8 Starting an existing machines with podman preset will return an error 095fb5fe Podman preset deprecation: Remove all usages of the Podman preset from the code - remove podman preset specific code - reject podman as a valid preset value for new machines 2b6d22c4 build(deps): bump golang.org/x/net from 0.22.0 to 0.24.0 91e67b6e build(deps): bump github.com/klauspost/compress from 1.17.7 to 1.17.8 3ce83974 CI: Add .snyk file to consumed by openshift ci's security scanning f28aa35e build(deps): bump golang.org/x/tools from 0.19.0 to 0.20.0 in /tools 977e674f build(deps): bump libvirt.org/go/libvirtxml from 1.10001.0 to 1.10002.0 903ae567 build(deps): bump peaceiris/actions-gh-pages from 3 to 4 de1ebb95 build(deps): bump golang.org/x/sync from 0.6.0 to 0.7.0 c725e56c build(deps): bump golang.org/x/crypto from 0.21.0 to 0.22.0 3adaf06b build(deps): bump golang.org/x/term from 0.18.0 to 0.19.0 2331271a Avoid using syscall.Sysctl to get macOS version a229bd6f build(deps): bump github.com/shirou/gopsutil/v3 from 3.24.2 to 3.24.3
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.34.1 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
NOTE: The Podman preset is deprecated and will be removed in a future release. Consider rather using a Podman Machine managed by Podman Desktop.
crc setup as well as crc start #4082
crc podman-env is ran and not when crc oc-env is used #4022
b470b5f6 cut v2.34.1
54c0e8bd build(deps): bump github.com/onsi/gomega from 1.31.1 to 1.32.0
dada0fce [e2e] Change tag for httpd image on openshift story
5126da6b Update OKD version to 4.15.0-0.okd-2024-02-23-163410
ec910cf5 docs: updated systems requirement for OpenShift 4.15
16e07ab1 e2e: Increase disk size to 40G for openshift story
7e694aec Increase memory resource from 9126 to 10752
8bd4b783 Update OpenShift and MicroShift bundle to 4.15.3 (stable channel)
f22e901f build: Update gvisor-tap-vsock go module
7b901a11 build: Update k8s and openshift go modules
0cd39c48 telemetry: do not return an error when identify hash file is malformed
37b3ee19 gha: specify paths that trigger windows workflow
c3d38f54 build(deps): bump github.com/onsi/ginkgo/v2 from 2.17.0 to 2.17.1
e2585055 windows: Fix 'should be ran' typo
75862f43 windows: Explain when fixUserPartOfCrcUsersAndHypervAdminsGroup is needed
ce112823 windows: Run StartupOnly checks at setup time instead
7436243b windows: Fix permission of private ssh keys
b9337534 build(deps): bump github.com/docker/docker
db35db84 cut v2.34.0
317f8995 update microshift bundle to v4.15.0
fe2a9176 update macos preflight checks unit test
faceda31 build(deps): bump github.com/onsi/ginkgo/v2 from 2.16.0 to 2.17.0
fca672b0 build(deps): bump github.com/zalando/go-keyring from 0.2.3 to 0.2.4
b3795948 build(deps): bump github.com/ProtonMail/go-crypto
9c6d8a3e build(deps): bump google.golang.org/protobuf from 1.32.0 to 1.33.0
402b9b9b build(deps): bump google.golang.org/protobuf in /tools
fcbb3e64 qe: add podman command to path
8f082a2e e2e: make sure CheckCRCStatus is logging
a3aa3af7 e2e: add memory size option
d29ca54c e2e: wait for monitoring operator
49605909 e2e: oc login with --insecure-skip-tls-verify
9bf6f4df build(deps): bump golang.org/x/tools from 0.18.0 to 0.19.0 in /tools
4026f7f8 preflight: add check to remove podman from ~/.crc/bin/oc
012cf33e create symlink for podman in ~/.crc/bin/podman dir
77d0a2e9 build(deps): bump github.com/go-jose/go-jose/v3 from 3.0.2 to 3.0.3
f0ab72b4 build(deps): bump gopkg.in/go-jose/go-jose.v2 from 2.6.1 to 2.6.3
953da552 kubeconfig: add unit test for addContext
e33e6613 kubeconfig: move code requesting user token to separate function
1db42c4e build(deps): bump github.com/onsi/ginkgo/v2 from 2.15.0 to 2.16.0
48095a96 build(deps): bump github.com/containers/image/v5 from 5.29.2 to 5.30.0
980760ba build(deps): bump libvirt.org/go/libvirtxml from 1.10000.0 to 1.10001.0
c8d6e155 build(deps): bump golang.org/x/sys from 0.17.0 to 0.18.0
93c6fb5a build(deps): bump github.com/shirou/gopsutil/v3 from 3.24.1 to 3.24.2
d8289165 build(deps): bump github.com/stretchr/testify from 1.8.4 to 1.9.0
e94d390b lint: Ignore 'dotfiles' warnings in test/
e557690b lint: Fix 'superfluous-else' warning from revive
07b6cfb5 build(deps): bump github.com/golangci/golangci-lint in /tools
86f9a405 build(deps): bump github.com/ProtonMail/go-crypto
7b7c0356 build(deps): bump golang.org/x/crypto from 0.19.0 to 0.20.0
ce57b474 libvirt: Raise minimum supported version
ebadb510 macos installer: Default to using ad-hoc signing
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.33.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
gvisor-tap-vsock to v0.7.2
podman preset is deprecated and will be removed, user's will get a deprecation mesaage when run crc config set preset podman #4012
2222 used for SSH by crc is pre-allocated #3965
oc binaries previously these contained x86_64 binaries #846
Retain #835
c43b1728 cut v2.33.0 3f3acbab Add deprecation warning in case user are on macOS < 13 764f90d4 Move macos version compare to pkg/os/darwin 517fd85d Move launchd package to under darwin 6293916b update microshift and openshift bundles to 4.14.12 ea2242e9 build(deps): bump github.com/klauspost/compress from 1.17.6 to 1.17.7 e3bd9e3d build(deps): bump github.com/klauspost/cpuid/v2 from 2.2.6 to 2.2.7 2ffb6371 build(deps): bump golang.org/x/tools from 0.11.0 to 0.18.0 in /tools a2f1b655 kubeconfig: use correct clusterURL to append to username 5b6ede63 preflight: Fix tests with go 1.21 39a033d0 kubeconfig: Append /cluster to the AuthInfo added by crc 79297377 Change description message 2c346716 add preflight check for vsock SSH port 465df524 build(deps): bump golang.org/x/net from 0.20.0 to 0.21.0 2e24cf90 build(deps): bump golang.org/x/crypto from 0.18.0 to 0.19.0 ddb8e8fe docs: removed Podman preset mentions - fixes #4003 76e7517b build(deps): bump golang.org/x/sys from 0.16.0 to 0.17.0 5b2bd0cf build(deps): bump github.com/containers/gvisor-tap-vsock 6c669ef6 build(deps): bump github.com/cucumber/godog from 0.13.0 to 0.14.0 7aec22d8 build(deps): bump actions/setup-go from 4 to 5 81eb68cc deprecated preset: add warning for podman preset during and commands f9b75fdd build(deps): bump actions/upload-artifact from 3 to 4 494e3316 build(deps): bump dawidd6/action-download-artifact from 2 to 3 056c8982 build(deps): bump actions/checkout from 3 to 4 2e551af3 build(deps): bump github.com/klauspost/compress from 1.17.5 to 1.17.6 9699692f gha: rearrange steps to avoid provisioning unnecessarily f40c651f gha: clarify information in the commit status ee707579 gha: unify all windows artifacts builds into one workflow 24a65526 build(deps): bump github.com/shirou/gopsutil/v3 from 3.23.12 to 3.24.1 e5651aff build(deps): bump github.com/opencontainers/runc from 1.1.10 to 1.1.12 2823909b build(deps): bump github.com/containers/image/v5 from 5.29.1 to 5.29.2 c37d4b20 crc status: remove redundant workaround on windows dfbbf231 build(deps): bump github.com/spf13/viper from 1.17.0 to 1.18.2 ea68faa1 build(deps): bump github.com/onsi/gomega from 1.30.0 to 1.31.1 7a3f85ef build(deps): bump github.com/onsi/ginkgo/v2 from 2.13.0 to 2.15.0 73b3d176 build(deps): bump github.com/cheggaaa/pb/v3 from 3.1.4 to 3.1.5 10dd5169 build(deps): bump github.com/shirou/gopsutil/v3 from 3.23.11 to 3.23.12 de5d64f3 build(deps): bump github.com/klauspost/compress from 1.17.4 to 1.17.5 f3ad4888 build(deps): bump github.com/crc-org/vfkit from 0.5.0 to 0.5.1 adcf91cb build(deps): bump libvirt.org/go/libvirtxml from 1.9008.0 to 1.10000.0 f7083293 build(deps): bump github.com/containers/image/v5 from 5.29.0 to 5.29.1 cc75401e build(deps): bump github.com/crc-org/admin-helper from 0.0.12 to 0.5.2 8928b6eb build(deps): bump github.com/yusufpapurcu/wmi from 1.2.3 to 1.2.4 fc36a074 build(deps): bump github.com/ProtonMail/go-crypto 0cc6efe5 build(deps): bump actions/checkout from 3 to 4 5af2de4b build(deps): bump dawidd6/action-download-artifact from 2 to 3 2ab97a0d build(deps): bump actions/upload-artifact from 3 to 4 b96b497f build(deps): bump actions/setup-go from 4 to 5 88975916 github: Allow dependabot to file PRs a82f0b52 build: Update gvisor-tap-vsock to v0.7.2
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.32.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
crc-libvirt-driver to 0.13.7
crc status --watch was not rendered properly #3936
54a6f9a1 cut v2.32.0 1b5e7c21 CI: Add github action to test OKD bundle 2b447fce Update OKD version to 4.14.0-0.okd-scos-2024-01-10-151818 2b661eb9 List disabled operators in the docs. cfd00421 update crc-driver-libvirt to 0.13.7 6be1dfe2 Turn off raw mode on Windows during status print ced1abd8 Fix docs-related make targets so they run on MacOS 6aae450a Update microshift/openshift version 4.14.8 (stable channel) 5f49891d dns: Don't use dnsmasq service as container 8456f744 gha: add windows e2e 82ea1afe gha: add gh-context job to installer workflow 5a8b08a9 gha: remove windows-2019 from installer matrix
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.31.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
win32-background-launcher to start the daemon on windows, this should fix bugs around daemon starting #3901admin-helper to latest version (0.5.2)6d23b6aa cut v2.31.0 e2c0002a build(deps): bump github.com/cloudflare/circl from 1.3.6 to 1.3.7 0b4bae8f Update openshift/microshift bundle to 4.14.7 (stable channel) 9f7499a6 Added unit test for mergeConfigFile function 0ea947bb kubeconfig: Simplify mergeKubeConfigFile 9f8f5e9f kubeconfig: Use names more explicit than kubeconf{1,2} b047b1be update admin-helper to 0.5.2 77c72e70 network_darwin: Remove dead code e4fc9189 name the executable as crc-background-launcher.exe f1ee0322 cache: add win32-background-launcher to the cached binaries cb9eb30d preflight: use win32-background-launcher to start the daemon task fc4a3504 msi: add win32-background-launcher to installer c7fcb5a4 build(deps): bump golang.org/x/crypto from 0.16.0 to 0.17.0 a51ff983 update admin-helper to 0.5.1 c2de6761 gh-action: add workflow to build test images 9805e901 gomod: Update dependencies to their latest versions b919b645 gomod: Vendor OpenShift 4.14/k8s 0.27 code 136a6a04 kubeconfig: Stop using tokencmd.RequestToken() d41a4612 Update admin-helper to latest release 16ff0307 fix #3938 bash wrong syntax on integration oci entrypoint script
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.30.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
crc cleanup was not stopping the daemon process #3927
crc setup would mistakenly show an error if the daemon systemd service was already running #3913
b6532a3c cut v2.30.0 3350b871 update openshift and microshift bundle to 4.14.3 a4f7dc25 update okd bundle to 4.14.0-0.okd-2023-12-01-225814 e72f8f8e preflight: simplify isDaemonProcess function bb70f215 vfkit: Update to latest version (0.5.0) 6cfb0acd Update docs/modules/getting_started/partials/ref_minimum-system-requirements.adoc 026d3047 docs: clarify Windows OS requirements ccfb0b40 msi: display install location in the welcome dialog of installer 0e64b05b msi: remove dialog for customizing install location 79c3a5aa images: Switch to ubi8/go-toolset:1.20 f56e36bb macos: remove tray during upgrade e6f13c39 daemonclient: Fix CheckIfOlderVersion name 278d8405 preflight: Check daemon version when it's already running 34e501e0 preflight: Add unitStatusErr type e66957da preflight:systemd: Fix misleading error message aa3559ef CI: remove mac 11 from github action workflow c84ca018 macos: Require macOS 12 905141e4 Remove option to customize installation
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.29.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
crc unusable #3098 #3690
crc config set proxy-ca-file <relative-path>
crc start is failing on macOS 12.X and x86 architecture for 'openshift' preset #3914
da5f55e5 cut v2.29.0 c815fcae update openshift and microshift bundles to 4.14.1 7707b756 build(deps): bump google.golang.org/grpc from 1.55.0 to 1.56.3 c0bcd486 mention about wrong proxy config via env variable in error msg da1d72ee warn instead of fatal error when proxy configs are erroneous f7805313 config: Add config Path type and use it for proxy-ca-file 9354dd4c Cluster: Remove all the lease from cluster c501ebeb cluster: Don't return error if there is no machine-config-controller configmap 2975cb6b remove reference to the tray from docs 4f46d663 remove tray related functions keeping behind only cleanup checks for darwin 3b04d1bf Remove crc-tray from the installers 09e6f441 Update OKD version to 4.14.0-0.okd-2023-10-28-073550 9e31bb05 e2e: tekton webhook check revisited e2ac7b57 go.mod: Update gvisor-tap-vsock to latest release 1f072afd images: Update golang base image db9435aa Use 'Apple silicon' instead of 'M1' 008062bb align syntax with the rest 9e21d5e1 integration: use host-network-access for non-linux 30748b72 Fix coping e2e binary for integration tests as part of builder image 5863186a build: Don't read MODULEPATH from environment c0b949ee e2e: Improve crc-version default value 5365acfa images: ci: Use ubi9 image 3f2809e5 images: ci: Removed unused packages 6bec29f5 ci: Use pre-built e2e/integration test binaries b29d8f8b e2e: check if tekton-pipelines-webhook is running
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.28.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
persistent-volume-size to reserve disk space for persistent volumes when using the 'microshift' preset #3820
enable-bundle-quay-fallback to download the bundles from quay if unable to download from the default location, enable it using crc config set enable-bundle-quay-fallback true #3802
crc would hang when using a custom port for https ingress using ingress-https-port config setting. #3862
2.30.0, podman preset users should switch to using Podman machine insteade1f42dea cut v2.28.0
82e64272 update openshift and microshift bundles to 4.13.14
0b0452f1 images: build-e2e: Remove 'ux testing' references
735cc7d7 Revert "Add e2e ux required parameters to e2e makefile goal"
c7204cbb Remove CheckMachineNotExists
da7e5a9c [e2e] story_microshift ensures operational status for cluster before deploy the sample service
55a10144 build(deps): bump golang.org/x/net from 0.12.0 to 0.17.0
2484015d Kubeconfig: Use user provided ingress https port for token dialer
bfb6c661 Fixes #3866 check if the script exists before trying to remove
65e3a588 tests: remove typo
90954147 integration: set CRCHome var before using it
18247ef4 tests: avoid using shell struct in CheckCRCStatus
032aa931 integration: extend timeout
4a9a35bb integration: wait for cluster in state
7abf1cf7 tests: move util functions to extended utils
22d9b7be integration: use default network mode for linux
2aa17e9d integration: cleanup to AfterAll and BeforeSuite
17179403 integration: refactor top-level testsuite info and actions
7e35a502 integration: run ginkgo nodes serially and in ordered fashion
4e822f02 Fix broken link to wiki page on userland network mode
2875a744 setting: Add 'enable-bundle-quay-fallback' option for config
6216f54d image: Add microshift preset to pull container image
38cb3afc Preflight: Add getPreflightChecksHelper function
fedda021 convert file path to file uri in TestVerifiedHash
dce8f6ac update to actions/setup-go@v
a5c9315d update to go 1.20
28f6dd15 remove use of rand.seed
ad0f49cc start: Use RunPrivate for checking pull secret for microshift
02e1f697 build: Add missing /v2/ to imports
5cc6a320 Validation: Put more meaningful message in case invalid bundle path
1f00507e validation: Change InvalidPath => invalidPath (make it private)
f97ca2c2 Preflight: Remove ValidateBundle logic as part of bundleExtract
7c2148b4 cmd/setup: Use ValidateBundle for pre validation checks
35fc1711 Validation: Don't fail if the bundle path is same as default path
788c460d Issue #3742 Improve preset config change message
85cc7183 Cache bundle's sha256sum signed file for unit test
26ea62ef Add file protocol support for download.Inmemory function
d7455751 Add persistent volume size option to config
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.27.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
71615e76 cut v2.27.0 f8878c17 e2e: Fix syntax for commands to check cluster certs cc384f39 Updated OKD version to 4.13.0-0.okd-2023-09-03-082426 6e8105b4 docs: added goatcounter 735d4ad0 docs: fixed publication bc5def58 docs: fixed broken links and adopted htmltest - fixes #3834 18cdd4ac docs: added an Antora extension that get versions from Makefile an inject the result as AsciiDoc attributes f69c3376 Refactor: Move logic to get default image uri to constants 22d9ec46 update openshift and microshift bundles to 4.13.12 e997963d chore: enable search in upstream docs website - fixes #3830 c8c64f9b Update *.json as per editorconfig caf59b37 Update .yaml/.yml as per editorconfig 1ba79240 Add editor config file 9ccf0b89 Revert "proxy: Add fallback to x509.NewCertPool() on Windows" 45831b0e gpg: Remove incorrect %w from error string 10a36ba3 bundle: Use switch case for default bundle 971188a0 bundle: Add more generic getVerifiedHash helper 4b2f8878 bundle: Remove bundle version check from downloadDefault() d8915539 bundle: Make downloadDefault private to the package f76e4b9e go.mod: Append /v2 to module URL e369b621 download: Set UserAgent in Download() 125f20a0 download: Simplify InMemory() 0ea71dd0 download: Remove unneeded args from InMemory e5d847ec Move GetCRCLatestVersionFromMirror to 'bundle' package
Downloads are available at: https://developers.redhat.com/content-gateway/rest/mirror/pub/openshift-v4/clients/crc/2.26.0 To use these binaries follow the instructions at https://console.redhat.com/openshift/create/local to obtain the needed pull-secret.
crc setup due to powershell having Restricted ExecutionPolicy #3812
233df0ee cut v2.26.0 7d7effb2 update openshift and microshift bundles to 4.13.9 1f1c4aa1 preflight: add cleanup check to kill daemon process d72f292a Add app routes for microshift preset 0c64b230 start daemon posh script with RemoteSigned execution policy 211e9dd7 start: Ignore pull secret update in the instance for stop => start af777917 extract: Add zipslip test 9a417c45 extract: Handle './' in archives 557ec94a e2e test: Ignore network-mode config property for non linux platform c21cdc3a Move TrimTrailingEOL helper to pkg/strings 03449df0 proxy: Update trimTrailingEOL function to handle carriage return (\r) 346ce344 CI: Make sure oc command is available before any oc operations