---
title: 快速安装
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

- 在 Kubernetes 集群上安装，请参考 [高级安装](./platform-engineers/advanced-install#install-kubevela-with-existing-kubernetes-cluster).
- 升级 KubeVela 请参考 [升级文档](./platform-engineers/advanced-install#upgrade).

## 1. 安装 VelaD

[VelaD](https://github.com/kubevela/velad) 作为 KubeVela 的快速安装工具，帮助你在具有 Docker 的环境中快速一键完成安装。

- VelaD 继承了 [K3s](https://rancher.com/docs/k3s/latest/en/quick-start/) 和 [k3d](https://k3d.io/) 的能力，同时将 KubeVela 所需的制品整体打包。
- VelaD 可以帮助你在离线环境中完成安装。
- VelaD 目前仅适用于快速体验和测试开发， [生成环境安装请参考高级安装文档](./platform-engineers/advanced-install#install-kubevela-with-existing-kubernetes-cluster)。

### 前提条件

- Docker v20.10.5+ (runc >= v1.0.0-rc93) **or** Linux system

### 下载 VelaD

- ** MacOS/Linux **

```shell
curl -fsSl https://static.kubevela.net/script/install-velad.sh | bash -s 1.4.1
```

- **Windows**

```shell
powershell -Command "iwr -useb https://static.kubevela.net/script/install.ps1 | iex"
```

`velad` 和 `vela` 命令行工具将存储于 `/usr/local/bin/`，对于 Windows，存储于 `C:\vela\`。

### 一键安装

```shell
velad install
```

查看到以下输出则代表安装成功:

```
Preparing K3s images...
Successfully prepare k3s image:  /Users/sunjianbo/.vela/velad/k3s/k3s-airgap-images-amd64.tgz
Successfully prepare k3d images

...snip...

KubeVela control plane has been successfully set up on your cluster.
If you want to enable dashboard, please run "vela addon enable /Users/sunjianbo/.vela/addons/velaux"

Keep the token below if you want to restart the control plane
K1075e7f6c77555e6ebdaf4854e4a2f39ae4287cfad23f27cdac5b33608d44633fe::server:zSpzbdbGzVxOwfBvvjgT

🚀  Successfully install KubeVela control plane
🔭  See available commands with `vela help`
```

### 设置 KubeConfig

```
export KUBECONFIG=$(velad kubeconfig --host)
vela comp
```

## 2. 安装 VelaUX

VelaUX 是面向企业的应用交付控制台和可视化平台。

```shell script
vela addon enable ~/.vela/addons/velaux
```

查看到以下输出则代表安装成功:

```
Addon: velaux enabled Successfully.
```

默认情况下，你可以通过以下方式快速访问到 VelaUX:

```
vela port-forward addon-velaux -n vela-system 8080:80
```

Choose `> Cluster: local | Namespace: vela-system | Component: velaux | Kind: Service` for visit.

如果你希望使用更稳固的访问方式，请参考 [VelaUX 高级安装说明](./reference/addons/velaux)。

VelaUX 是需要登陆认证的，默认管理员账号为 `admin` 密码为 `VelaUX12345`。请首次登陆成功后修改管理员密码并谨记。

## 3. 卸载

```
velad uninstall
```

此命令将删除 VelaD 安装的环境, 其他自定义方式安装的请参考 [KubeVela 卸载文档](./platform-engineers/advanced-install#uninstall)。

## 下一步

- [部署第一个应用](./quick-start)。
