Quickstart

This quickstart installs StormForge on your Kubernetes cluster with a single Helm command. StormForge starts generating preliminary recommendations within 10 minutes. Complete, actionable recommendations are ready after a 7-day learning period.

What you’ll need

• A Kubernetes cluster (EKS, AKS, GKE, minikube, kind, or any other distribution)
• A StormForge account — sign up for free at app.stormforge.io/signup
• helm installed locally

Install StormForge

1. Log in to app.stormforge.io.

   If this is your first time, you’ll be taken directly to the Add Cluster page.

2. Click Clusters in the left navigation, then click Add Cluster.

3. Give your cluster a name and click Continue.

   The cluster name can’t exceed 63 characters, can’t start or end with a dash (-), and must follow the RFC 1123 DNS label standard.

4. Copy and run the generated helm install command. It looks like this (with your credentials in place of CLIENT_ID and CLIENT_SECRET):

   helm install stormforge oci://registry.stormforge.io/library/stormforge \
     --create-namespace --namespace stormforge-system \
     --set clusterName="my-cluster" \
     --set authorization.clientID="CLIENT_ID" \
     --set authorization.clientSecret="CLIENT_SECRET"
   

Verify the installation

After a minute or two, confirm all pods are running:

kubectl get pods -n stormforge-system

You should see three pods:

NAME                                    READY   STATUS    RESTARTS   AGE
stormforge-agent-xxxxxxxxxx-xxxxx       2/2     Running   0          2m
stormforge-exporter-xxxxxxxxxx-xxxxx    1/1     Running   0          2m
stormforge-applier-xxxxxxxxxx-xxxxx     1/1     Running   0          2m

Back in the StormForge UI, click Check Connection. You’ll be redirected to the Overview page with a confirmation that the Agent is connected.

What happens next

StormForge is now collecting workload metrics.

• In ~10 minutes: Preliminary recommendations appear. These are previews — don’t apply them yet.
• Over 7 days: StormForge collects metrics and refines its model.
• After 7 days: Complete recommendations are generated daily. These are ready to review and apply.

Apply your first recommendation

Once a complete recommendation is available:

1. In the StormForge UI, click Workloads.
2. Select a workload, then click its name to view the recommendation details.
3. Click Apply Now to apply the recommendation immediately.

Next steps

• Enable automatic deployment — let StormForge apply recommendations on a schedule
• Configure — tune optimization goals, schedules, and how recommendations are applied