Create an FKS cluster

Fly Kubernetes is in beta and not recommended for critical production usage. To report issues or provide feedback, email us at beta@fly.io.

To create a Kubernetes cluster, run:

fly ext k8s create [--name <name> | --org <org> | --region <region>]

Once a cluster is provisioned, it will return a kubeconfig that can be used to connect to your cluster’s Kubernetes API server using kubectl.

For example:

apiVersion: v1
clusters:
  - name: fks-flyio-fksdemo
    cluster:
      certificate-authority-data: ...
      server: https://fks-flyio-fksdemo.flycast:6443
      extensions:
      ...
      ...
contexts:
  - context:
      cluster: fks-flyio-fksdemo
      user: default
    name: default
current-context: default
kind: Config
preferences: {}
users:
  - name: default
    user:
    ...
    ...

Your cluster is accessible over your organization’s private WireGuard network. To connect to your cluster, you need a WireGuard configuration.

Follow the Private Network VPN instructions to set up a permanent WireGuard connection to your Fly.io IPv6 private network.

Once set up, you can use kubectl:

> kubectl get ns
NAME              STATUS   AGE
kube-public       Active   22d
kube-node-lease   Active   22d
default           Active   22d
kube-system       Active   22d

Related topics

Open in ChatGPT
Report an issue or edit this page on GitHub