Skip to content

Create a cluster

A cluster is where your deployments run. Ownkube provisions two shapes in your AWS account: K3s (Starter) (K3s on one AWS instance, cheap and fast) and EKS (Production) (managed EKS, highly available across availability zones).

Start at your dashboard.

  • A connected AWS account. You can’t create a cluster without one.
  • An idea of what you’ll run on it. Dev, staging, or a side project? Starter. Production with real traffic? Production.

A single EC2 instance running lightweight Kubernetes. Free Ownkube platform fee. You only pay AWS for the EC2 instance, and AWS Activate or other startup credits cover that in full. Provisions in about 5 minutes. Best for dev, staging, side projects, and small production workloads.

  1. Start the wizard

    Open the create-cluster wizard from your dashboard and select Deploy on EC2.

  2. Name and target

    Pick a cluster name (e.g. side-project, dev), your AWS account, and a region. Names are lowercase, alphanumeric, with dashes.

  3. Pick an instance type

    InstancevCPUMemory~EC2 costGood for
    t3.medium24 GiB~$30 / moFirst apps, light prototypes
    t3.large28 GiB~$60 / moSmall production web + db
    t3.xlarge416 GiB~$120 / moMulti-service workloads
    t3.2xlarge832 GiB~$240 / moBusy workloads on one node

    No Ownkube platform fee on top, you pay AWS only. AWS Activate or other startup credits cover these EC2 costs in full.

  4. Review and create

    Starter clusters skip the separate networking and compute steps. Confirm the summary and click Create cluster. Provisioning takes about 5 minutes.

  1. Account setup runs once per AWS account

    On your first cluster, Ownkube creates shared IAM roles and a regional S3 bucket for state. This takes about a minute and only happens once per AWS account.

  2. VPC and networking

    A new VPC, subnets (public and private across AZs for EKS), NAT, and security groups are created for the cluster.

  3. Cluster control plane

    For EKS, the managed control plane is provisioned. For K3s, the EC2 instance is launched and bootstrapped.

  4. Platform components

    Ownkube installs the internal components that make the platform work: deployment pipeline, public routing, TLS, metrics collection.

  5. Cluster becomes active

    The cluster status flips to active on the dashboard. You can start creating deployments.

Once active, the cluster detail page in your dashboard lets you:

  • Review telemetry: node count, vCPU, memory, active deployments
  • Adjust compute capacity on EKS
  • View the cluster’s IAM role and VPC details
  • Upgrade the platform version when new versions are available
  • Delete the cluster when you’re done with it

See Clusters for the full reference.

  • One region per cluster. Clusters can’t span regions. Create separate clusters in separate regions.
  • Cluster types can’t convert. You can’t turn a K3s cluster into EKS. Create a new EKS cluster and move deployments.
  • Plan limits cap the number of clusters and total vCPU / RAM. See Pricing for tier limits.