OpenFrame Documentation
Deployment guides, the CLI reference, architecture and admin guides for OpenFrame
Flamingo Raises $4.5M Seed Round · Led by Vertex Ventures, bringing total funding to $6.7M to build the open, AI-native layer for IT and security.
Deployment guides, the CLI reference, architecture and admin guides for OpenFrame
at# How to create a new Kubernetes cluster with OpenFrame CLI
A platform operator uses the OpenFrame CLI's openframe cluster create command to provision a new Kubernetes cluster — locally on this machine, or in the cloud on GKE or EKS — as the first step before installing the OpenFrame platform onto it.
openframe CLI binary installed and on your $PATH. Windows users can get it from https://github.com/flamingo-stack/openframe-cli/releases/latest/download/openframe-cli_windows_amd64.zip; macOS/Linux users download the matching build from the project's Releases page, or run go install github.com/flamingo-stack/openframe-cli@latest.gcloud auth login, and the account has access to the target GCP project.aws sts get-caller-identity succeeds for the AWS profile you plan to use (or your default credentials), meaning the CLI can authenticate as you.openframe build re-executes itself inside WSL2 automatically before any cluster command runs.openframe cluster create to start creating a cluster. Add a name as an argument, for example openframe cluster create my-cluster, if you want a specific cluster name instead of the default.gcloud auth login (and the Application Default Credentials login) when asked.aws sts get-caller-identity) and confirm it is the account you want billed.infracost is available or you accept the CLI's offer to install it, review the estimated monthly cost line before continuing.openframe cluster create my-cluster --skip-wizard, optionally adding flags such as --nodes, --type, --region, --project, or --profile to set values directly instead of being prompted.kubectl or openframe command targets it automatically.<N>" — you passed --nodes with a value of zero or less in non-interactive mode. Re-run with a positive node count.--max-nodes — you explicitly set one of these flags to 0. Omit the flag to use the default, or set it to a positive number.<name>' already exists in region '<region>' but is not managed by openframe — refusing to touch it; pick another cluster name" (EKS), or the equivalent project-scoped message for GKE — a cluster with that name already exists outside this CLI's tracking. Choose a different cluster name.<profile or default credentials> cannot authenticate (aws sts get-caller-identity failed)" — your AWS credentials are not usable. Re-check your AWS CLI configuration or the --profile you passed before retrying.gcloud auth login when prompted, or run that command yourself first.<project>' is not accessible with the current gcloud identity", or "GCP project <project> is not among your accessible projects: ..." — the --project value does not match a project your gcloud identity can reach; rerun with a project from the list the CLI shows, or check access in the Google Cloud Console.<name>' already exists and points at <server> — refusing to overwrite it; rename the existing context or pick another cluster name" — a kubeconfig entry with the same name as your new cluster already points somewhere else. Rename the existing context yourself or choose a different cluster name for the new one.openframe cluster create with the same name to resume, or run openframe cluster delete to tear down what was created so far.terraform import command the CLI prints, then re-run create.infracost cannot produce an estimate, the CLI tells you to run infracost auth login (free, one-time) and re-run; this does not block cluster creation.