FAQ
Getting started
Accounts, prerequisites, platforms and how long up takes.
Do I need a Google Cloud account?
No.
cloudburrow env generates credentials for local tools. They grant no Google Cloud access.Source: docs/credentials.md, README.md (quick start)
Link to this answer Which version should I install, and what does On main mean?
Install the latest release, which the banner at the top of this site names; Homebrew and the install script take it by default. Anything that lands on main after a release is marked On main until the next release; to try it, build from source at the pinned commit.
Source: docs/install.md (build from source)
Link to this answer Can I start a cluster without internet access?
Since v0.2.0, run
cloudburrow prefetch while online for the service profile you plan to use, then cloudburrow up --offline. If a required artifact is missing, startup stops before creating a cluster.Source: docs/install.md (offline and air gapped use), cmd/cloudburrow/offline_integration_test.go
Link to this answer What do I need installed?
Docker, kind and kubectl; Go only to build from source. Give Docker at least 4 CPU and 6 GB.
Source: docs/install.md (prerequisites), README.md (quick start)
Link to this answer Does it run on Windows?
No. WSL2 is untested.
Source: docs/status.md (platforms)
Link to this answer Are the macOS binaries signed?
Yes, from v0.2.0: the macOS binaries are signed with a Developer ID and notarized by Apple (v0.1.0 was unsigned). Every archive also has a SHA-256 checksum and a GitHub build attestation; see Gatekeeper in docs/install.md.
Source: issue #605, docs/install.md (gatekeeper)
Link to this answer Can I use Podman or rootless Docker?
Not supported. colima, OrbStack and Rancher Desktop are unverified.
Source: docs/install.md (container engines)
Link to this answer How long does up take?
up take?One measured run on Linux: 85 s cold, 30 s warm, default profile. A single measurement.
Source: docs/status.md (footprint)
Link to this answerDevelop locally
Build against Google Cloud APIs, locally
Free and open source under Apache-2.0. No account, no sign-up, no Google Cloud bill.