Getting Started

Obtain Access Credentials
​Sign up for CoreWeave Cloud and generate a kubeconfig from the API Access page. Every time an Access Token is generated, by default the corresponding kubeconfig will automatically download. This kubeconfig file allows you to interact with our Kubernetes cluster using kubectl and other Kubernetes applications.
On CoreWeave's Access Token page click "Generate your first token" (or "Generate another token" if you have already generated a kubeconfig) and optionally give the token a recognizable name. Once you create it, a new kubeconfig will be generated that embeds the access token. By __ default your corresponding kubeconfig will automatically download. The browser might ask where to save the file cw-kubeconfig.
The generated kubeconfig file is used to interact with our Kubernetes cluster using clients like kubectl, etc.
Access Tokens are used for programmatic access to CoreWeave Cloud applications like Prometheus​
The kubeconfig and Access Token is shown & given one time! Be sure to save in a secure location. You can find your access token embedded inside your kubeconfig file if misplaced.
Install Kubernetes Command Line Tools
Once you have obtained your credentials, all you have to do is put them in place and download the command line tools. No other setup is necessary, you are instantly ready to deploy your workloads and containers. Cut-and-paste instructions are below. For more detail please reference the official documentation.
Linux
Mac OSX
Windows
The following command will install kubectl on your Linux system.
1
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
Copied!
Once you have kubectl downloaded, you can install it by moving the file into the system bin folder.
1
chmod +x ./kubectl
2
sudo mv ./kubectl /usr/local/bin/kubectl
Copied!
If you prefer to installing using the native package manager, please view Kubernetes guide on Installing using Native Package Manager.
Verify kubectl Binary
If you'd like to verify kubectl, you can verify it by running:
1
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
2
echo "$(<kubectl.sha256) kubectl" | sha256sum --check
Copied!
This should return kubectl: OK to confirm it is indeed valid. If this returns an error, please review the kubectl installation guide from Kubernetes.
Most Mac users use brew to install packages, to install kubectl run the command below:
1
brew install kubectl
Copied!
If you don't have brew installed, follow the Brew Installation guide.
Install Using PowerShell
If you use PowerShell, install kubectl using the following the command:
1
& $([scriptblock]::Create((New-Object Net.WebClient).DownloadString('https://raw.githubusercontent.com/coreweave/kubernetes-cloud/master/getting-started/k8ctl_setup.ps1')))
Copied!
Add -Silent to the end of this string for a non-interactive setup.
Install using Package Manager
You can also install kubectl on Windows using either Chocolatey or Scoop using the following commands:
Using Chocolatey:
1
choco install kubernetes-cli
Copied!
Using Scoop:
1
scoop install kubectl
Copied!
If you prefer to download the kubectl exe file directly, download the latest version.
Setup Kubernetes Config
Once you have kubectl installed and the kubeconfig file generated and downloaded you can begin to use CoreWeave's Kubernetes infrastructure! To copy/merge with kubectl you can run the following commands:
1
# create a backup of current kubeconfig
2
cp ~/.kube/config ~/.kube/config.bak
3
​
4
# install CoreWeave Kubernetes credentials
5
KUBECONFIG=~/.kube/config:~/Downloads/cw-kubeconfig \
6
  kubectl config view --merge --flatten > ~/.kube/config
Copied!
Be sure to replace ~/Downloads directory with the location of your generated kubeconfig.
The command above will create a backup of your kubeconfig at ~/.kube/config.bak
Default kubectl Directory
Linux path: ~/.kube/config
MacOSX path: /Users/<username>/.kube/config
Windows Path: %USERPROFILE%\.kube\config
Verify Kubernetes Credentials
Since your new account will not have any resources, listing the secrets is a good start to ensure proper communication with the cluster. To verify your CoreWeave Kubernetes configs using kubectl you can run the following commands:
1
kubectl config set-context coreweave
2
kubectl get secret
Copied!
The command above should return your default secrets like so,
1
NAME                           TYPE                                  DATA   AGE
2
default-token-frqgm            kubernetes.io/service-account-token   3      3h
Copied!
Congratulations! 🎉
 You're ready to use CoreWeave Cloud!
Your system is ready to deploy all types of services on CoreWeave's Kubernetes infrastructure. Checkout some of the examples by heading over to Examples.Your file is as secret as your password! Keep it safe, and do not share.