# aks-desktop

**Repository Path**: mirrors_Azure/aks-desktop

## Basic Information

- **Project Name**: aks-desktop
- **Description**: AKS desktop delivers an application focused experience for deploying and managing workloads on Azure Kubernetes Service.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-21
- **Last Updated**: 2026-02-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AKS desktop

AKS desktop delivers an application focused experience for deploying and managing workloads on Azure Kubernetes Service.

Built on top of open-source [Headlamp](https://headlamp.dev), AKS desktop provides a guided, self-service UX built on supported AKS features and best practices. Designed to work within your existing environment and tools, it enables team collaboration through RBAC while abstracting complexity without removing control.

To learn how to get started with AKS desktop, create projects, deploy applications, and explore the full set of features, check out the [official AKS desktop documentation](https://aka.ms/aks/aks-desktop).

[![OpenSSF Best Practices](https://www.bestpractices.dev/projects/11652/badge)](https://www.bestpractices.dev/projects/11652)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/Azure/aks-desktop/badge)](https://scorecard.dev/viewer/?uri=github.com/Azure/aks-desktop)

## Installation

Please download the latest release for your platform from the [Releases](https://github.com/Azure/aks-desktop/releases/latest) page.

## Development

To run AKS desktop locally, follow these steps:

1. Clone the repository:

   ```bash
   git clone --recurse-submodules https://github.com/Azure/aks-desktop.git
   ```

2. Navigate to the project directory:

   ```bash
   cd aks-desktop
   ```

3. Install the dependencies:

   ```bash
   ./scripts/headlamp-submodule.sh --reset
   npm install
   npm run install:all
   ```

4. Check for the resource folder:

   Ensure that the `resources` folder exists in the `headlamp/app` directory.
   If `headlamp/app/resources` does not exist, run the following command from the root directory.

   ```bash
   npm run plugin:setup
   ```

5. Build the Headlamp backend server:

   Navigate to the `headlamp` directory and build the backend server

   ```bash
   cd headlamp
   make backend
   ```

6. Start the application at the root directory:

   Navigate back to the root directory and start the application in development mode:

   ```bash
   npm run dev
   ```

## How to Build

To get started with AKS desktop, follow these steps:

1. Clone the repository:

   ```bash
   git clone --recurse-submodules https://github.com/Azure/aks-desktop.git
   ```

2. Navigate to the project directory:

   ```bash
   cd aks-desktop
   ```

3. Install the dependencies:

   ```bash
   ./scripts/headlamp-submodule.sh --reset
   npm install
   npm run install:all
   ```

4. Build the project:
   ```bash
   npm run build
   ```

## Documentation

- [Cluster Requirements](docs/cluster-requirements.md) — What your AKS cluster needs for the best AKS desktop experience

## Contributing

Check out the [CONTRIBUTING.md](CONTRIBUTING.md) file. More
details on how to contribute will come soon.

## Support

See [SUPPORT.md](SUPPORT.md) for information on how to get help with this project.

## Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must [follow Microsoft’s Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks). Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.