Getting Started

Obtaining CoreWeave Access Credentials
On CoreWeave, Kubeconfig files are used to interact with our Kubernetes cluster by using clients such as kubectl, and API Access Tokens are used for programmatic access to CoreWeave Cloud applications such as Prometheus.
To generate your access credentials, first sign up for CoreWeave Cloud. Once you have an account, log in to the Cloud UI, then navigate to the API & Kubeconfig page from the left-hand side menu.
The Cloud UI API Access page
Warning
The Kubeconfig and Access Token is shown and given only once! Be sure to save this file and the token in a secure location. If you lose your Access Token, it can be found inside your Kubeconfig file.
From the Cloud UI API Access page, click the New Token & Kubeconfig button at the top right. When prompted, give the token a recognizable name, then click the Generate button. Generating the new token will also create a Kubeconfig file in which that token will be embedded, which will download automatically.
Note
If you would like to prevent the Kubeconfig file from downloading automatically, un-check the Automatically download Kubeconfig checkbox.
Create a new access token dialog box
Installing the Kubernetes Command Line Tools
Once you have obtained your Access Credentials, all you have to do is put them in the right place and download the Kubernetes command line tools.
No other setup is necessary; once you install the command line tools as described below, you will be ready to deploy your workloads and containers!
Additional Resources
For more information on Kubernetes installation and configuration, please reference the official Kubernetes documentation.
Linux
macOS
Windows
Installing kubectl on a Linux system
Downloading and installing the binary
The following command is a simple way to install kubectl on your Linux system by downloading the binary.
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
Once you have the kubectl binary downloaded, install it by first making the binary executable:
$ chmod +x ./kubectl
Then, move the file into the system bin directory:
$ sudo mv ./kubectl /usr/local/bin/kubectl
​
Note
If you would prefer to install Kubernetes using a Native Package Manager, please view the Kubernetes guide on Installing using Native Package Manager.

Verifying the kubectl binary
If you'd like to verify kubectl, you can verify it by running a checksum operation on the downloaded file prior to installing it, such as:
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
echo "$(<kubectl.sha256) kubectl" | sha256sum --check
This should return kubectl: OK to confirm the file is indeed valid. If this returns an error, please review the official kubectl installation guide.
Installing kubectl on a Linux system
Installing using Homebrew
Most Mac users use Homebrew to install packages.
If you do not already have Homebrew installed, follow the Brew Installation guide to do so, then install kubectl using Homebrew by running the following command:
$ brew install kubectl
Installing kubectl on a Windows system
Installing using PowerShell
Using PowerShell, kubectl can be installed by using the following the command:
& $([scriptblock]::Create((New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/coreweave/kubernetes-cloud/master/getting-started/k8ctl_setup.ps1')))
​
Note
Add the -Silent flag to the end of this string for a non-interactive setup.
​
Installing using a Package Manager
You can also install kubectl on Windows using a package manager such as Chocolatey or Scoop.
Using Chocolatey:
$ choco install kubernetes-cli
Using Scoop:
$ scoop install kubectl
If you would prefer to download the kubectl executable directly, follow the official Kubernetes instructions to download the latest version.
Configuring Kubernetes
Once you have kubectl installed and the Kubeconfig file is generated and downloaded, you can begin to use CoreWeave's Kubernetes infrastructure! To copy and merge the Kubeconfig file, you can run the following commands using kubectl:
First, create a backup copy of the Kubeconfig file:
$ cp ~/.kube/config ~/.kube/config.bak
Next, install the CoreWeave Kubernetes credentials by merging the config file into ~/.kube/config, which is the default Linux filepath that Kubernetes uses to source configuration settings.
$ KUBECONFIG=~/.kube/config:~/Downloads/cw-kubeconfig \
kubectl config view --merge --flatten > ~/.kube/config
If you are working on a different kind of system, replace ~/.kube/config with one of the following, and be sure to replace the ~/Downloads path in this example with the actual location of your downloaded Kubeconfig file, and the default path with the one applicable to your system.
Default Kubernetes configuration directories by OS
Operating System
Default path
Linux
~/.kube/config
macOS X
/Users/<username>/.kube/config
Windows
%USERPROFILE%\.kube\config
Verify Kubernetes credentials
Since your new account will not yet have any resources, listing your cluster secrets is a good way to test that proper communication with the cluster is in place. To verify your CoreWeave Kubernetes configuration using kubectl, invoke the following commands.
First, set the Kubernetes context to coreweave:
$ kubectl config set-context coreweave
Next, request the secret objects:
$ kubectl get secret
This should return your default secrets, such as:
NAME                           TYPE                                  DATA   AGE
default-token-frqgm            kubernetes.io/service-account-token   3      3h
Congratulations! 🎉
 
You are now ready to use CoreWeave Cloud!
Your system is ready to deploy all types of services on CoreWeave's Kubernetes infrastructure. 
​Check out some examples of what you can do.

Release Notes

Next - CoreWeave Kubernetes

Useful Commands

Last modified 17d ago

Copy link

On this page

Obtaining CoreWeave Access Credentials

Installing the Kubernetes Command Line Tools

Configuring Kubernetes

Congratulations!

Obtaining CoreWeave Access Credentials

Installing the Kubernetes Command Line Tools

Installing kubectl on a Linux system

Downloading and installing the binary

Installing kubectl on a Linux system

Installing using Homebrew

Installing kubectl on a Windows system

Installing using PowerShell

​

Installing using a Package Manager

Configuring Kubernetes

Default Kubernetes configuration directories by OS

Verify Kubernetes credentials

Congratulations! 🎉