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?

One measured run on Linux: 85 s cold, 30 s warm, default profile. A single measurement.

Source: docs/status.md (footprint)

Link to this answer
Develop locally

Build against Google Cloud APIs, locally

Free and open source under Apache-2.0. No account, no sign-up, no Google Cloud bill.

Get started