---
title: Kubeconfig file as Env Variable
---

# Setting the Kubeconfig File as an Environment Variable

To configure Kubernetes access on different operating systems, you can set the `KUBECONFIG` environment variable to point to your specific Kubernetes configuration file (`kubeconfig.yaml`). This allows Kubernetes command-line tools like `kubectl` to automatically use the configuration without needing the `--kubeconfig` flag every time.

---

## For Linux

1. **Download the Kubeconfig File** — Log in to the MyAccount dashboard, navigate to your Kubernetes cluster, and download the kubeconfig file (typically named `kubeconfig.yaml`) from the cluster details section.

2. **Set the Kubeconfig Path** — Open your terminal and edit the `.bashrc` file in your home directory:
   ```bash
   vim ~/.bashrc
   ```

3. **Add the Environment Variable** — Add the following line at the end of the `.bashrc` file. Replace `/path/to/your/kube-config-file` with the actual path to your downloaded `kubeconfig.yaml`:
   ```bash
   export KUBECONFIG="/path/to/your/kube-config-file"
   ```

4. **Apply the Changes** — Reload the `.bashrc` file to apply the new variable:
   ```bash
   source ~/.bashrc
   ```

5. **Verify the Configuration** — Confirm access to your cluster without the `--kubeconfig` flag:
   ```bash
   kubectl get nodes
   ```

---

## For Windows

1. **Download the Kubeconfig File** — Log in to the MyAccount dashboard, navigate to your Kubernetes cluster, and download the kubeconfig file (typically named `kubeconfig.yaml`) from the cluster details section.

2. **Set the Environment Variable for a Specific User** — Open PowerShell with Administrator privileges by right-clicking the PowerShell icon and selecting **Run as Administrator**. Then run:
   ```powershell
   [System.Environment]::SetEnvironmentVariable("KUBECONFIG", "C:\Users\UserName\Downloads\kubeconfig.yaml", [System.EnvironmentVariableTarget]::User)
   ```

3. **For All Users (Global System-Wide)** — To set the environment variable for all users on the machine, run:
   ```powershell
   [System.Environment]::SetEnvironmentVariable("KUBECONFIG", "C:\Users\Administrator\Downloads\kubeconfig.yaml", [System.EnvironmentVariableTarget]::Machine)
   ```

4. **Verify the Configuration** — Confirm access to your cluster without the `--kubeconfig` flag:
   ```powershell
   kubectl get nodes
   ```

---

## For macOS

1. **Download the Kubeconfig File** — Log in to the MyAccount dashboard, navigate to your Kubernetes cluster, and download the kubeconfig file (typically named `kubeconfig.yaml`) from the cluster details section.

2. **Set the Kubeconfig Path** — Open the terminal and edit the `.zshrc` file in your home directory:
   ```bash
   vim ~/.zshrc
   ```

3. **Add the Environment Variable** — Add the following line at the end of the `.zshrc` file. Replace `/path/to/your/kube-config-file` with the actual path to your downloaded `kubeconfig.yaml`:
   ```bash
   export KUBECONFIG="/path/to/your/kube-config-file"
   ```

4. **Apply the Changes** — Reload the `.zshrc` file to apply the new variable:
   ```bash
   source ~/.zshrc
   ```

5. **Verify the Configuration** — Confirm access to your cluster without the `--kubeconfig` flag:
   ```bash
   kubectl get nodes
   ```

---

## Key Points

- **KUBECONFIG Variable** — Setting this environment variable tells `kubectl` and other Kubernetes tools where to find your kubeconfig file.
- **Path Customization** — Replace `/path/to/your/kube-config-file` with the actual path to the kubeconfig file on your system.
- **Verification** — After setting the variable and applying the changes, run `kubectl get nodes` to confirm you can access your Kubernetes cluster.


---