Skip to main content

​
Overview

This guide will walk you through how to quickly install Thoras and get to see resource recommendations for your workloads in just a few minutes.

​
What you’ll need

  1. Your Thoras license key (email support@thoras.ai if you don’t have one)
  2. Helm
  3. Privileged access to a Kubernetes cluster
  4. The cluster should have Kubernetes metrics server installed. It probably already has this!
For optimal forecast accuracy and full Autonomous Mode support, Thoras needs a Kubernetes Persistent Volume (PV) to store historical metrics.This QuickStart intentionally skips that setup so you can get the product running quickly and start exploring waste insights right away. If you prefer to include the PV during initial installation, review the Persistent Storage before proceeding with the Install Thoras steps below. You can also always add a PV as a follow-on step.

​
Install

Let’s get Thoras up-and-running!

​
Use the Thoras Helm repo

Install the Thoras Helm repo, which will give you access to all of the Thoras Helm charts.

​
Install Thoras

  1. Note the name of your license key file. We’ll use thoras_license.txt in our example below.
  2. Install Thoras via Helm:
featureFlags.enableLegacySecretSeeding exists only so clusters upgrading from chart 4.x can migrate their existing credentials. A fresh install has nothing to migrate, so turning it off keeps the release clean. See Upgrading if you’re coming from 4.x.
The chart ships with defaults that should work for most initial deployments. See Advanced Setup for the common configuration knobs, or the full values reference on GitHub. Need to set up license secret externally? See Advanced Setup.

​
Verify installation

It should only take 1-2 minutes for all Thoras pods to come online. Verify that all pods are healthy by confirming their Running status:
On a fresh install, pods briefly report CreateContainerConfigError while the Thoras config-controller generates the credentials they need. This resolves on its own within a minute. No action is needed.
Once all pods are in Running status, congratulations! You’ve successfully installed Thoras!

​
Get Workload Resource Recommendations

Now that Thoras is up and running, we’re just minutes away from getting resource recommendations that will help our workloads run more efficiently, boosting reliability and saving on cloud costs.

​
View the dashboard

We’ll be working out of the Thoras Dashboard from here on out. To access it:
  1. Port-forward to the dashboard pod:
  2. Pull up the dashboard in your browser: http://localhost:8080
  3. The dashboard prompts for a username and password. The default username is thoras. Fetch the generated password with:
    See Dashboard authentication for how to change the credentials, sign in with your identity provider (Okta, Azure Entra ID), or bring your own auth. Before exposing the dashboard beyond localhost, terminate TLS at your ingress and set thorasDashboard.auth.cookieSecure: true.
Thoras will auto-discover workloads in your cluster and give you the option to onboard all the workloads in a namespace, with zero configuration needed. This is a great way to experiment and see the value of Thoras quickly!
  1. Select a namespace from the dropdown and click “Enroll Namespace” to enroll all associated workloads, or alternatively select individual workloads from the table below and click “Enroll Selected” to specify the workloads you’d like to target. This will enroll workloads into Recommendation Mode so they may begin receiving resource recommendations. This is a read-only operation. No changes will take place to your workloads. auto-create
  2. You’ll see a new popup where Thoras tells you it’s populating AIScaleTargets for you.
  3. Once complete, you’ll see a list of onboarded targets under the Recommendation tab on the Home page. Click “View” to see more! live-targets
  4. You should immediately see metrics beginning to collect! Use the slider below the graph to narrow the time window. metrics-collecting
  5. Predictions will run on a 15m interval. Grab a cup of coffee! ☕

​
Replica and resource recommendations

Predictions will become more accurate over time as the Thoras Reasoning Engine learns more about your environment. But we can still get useful predictions even on the first forecast! Let’s dive in.

​
Workload efficiency at a glance

The Pod Health widget will give you a quick overview of replica count recommendations and workload’s overall resource utilization. pod-health

​
Pod resource recommendations

Check out how much more efficiently, reliably, and cost-effectively your workloads could be running in the Resource Allocation Settings widget. resource-allocation

​
Getting support

For any questions, email support@thoras.ai.