# 在 Debian 上安装 EMQX

本页将指导您如何在 Debian 系统中下载安装并启动最新版 EMQX。

支持的 Debian 版本：

- Debian 13
- Debian 12
- Debian 11

如希望在其他支持系统中进行安装，或体验其他版本，可前往 [EMQX 企业版下载页面](https://www.emqx.com/zh/downloads-and-install/enterprise)获取安装信息。

::: tip
从 EMQX 6.3.0 开始，通过 DEB 包安装的 EMQX 可使用与 Docker 镜像相同的 `/opt/emqx/...` 路径。路径映射参见[文件和目录](./install.md#文件和目录)。
:::

## 通过 deb 安装

1. 前往官方下载页面，选择 [Debian 页签](https://www.emqx.com/zh/downloads-and-install/enterprise?os=Debian)。
2. 选择最新版本 `6.3.1`，在**安装包类型**中根据需要的版本和 CPU 架构选择 `deb` 安装包。
3. 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。

### 启动 EMQX 

systemctl 启动：

```bash
sudo systemctl start emqx
```

::: tip
从 EMQX 6.3.0 开始，可在 `/etc/emqx/emqx.env` 中设置启动期环境变量，例如 `EMQX_SECURITY_PROFILE`。`emqx` 命令每次执行时都会加载该文件，包括以服务方式启动、前台启动以及运行 `emqx ctl` 时。软件包升级会保留对该文件的修改。修改启动期环境变量后，重启 EMQX 节点以使更改生效。参见[启动期环境变量](../../guides/configuration/configuration.md#启动期环境变量)。
:::

### 卸载 EMQX

安装完成后，可通过如下命令卸载 EMQX：

```shell
sudo apt remove --purge emqx
```

## 通过 tar.gz 安装

1. 前往官方下载页面，选择 [Debian 页签](https://www.emqx.com/zh/downloads-and-install/enterprise?os=Debian)。
2. 选择最新版本 `6.3.1`，在**安装包类型**中根据需要的版本和 CPU 架构选择 `tar.gz` 安装包。
3. 点击下方的下载链接。您也可以参照命令行指导步骤进行下载与安装。

安装完成后，可通过如下命令启动 EMQX。

```bash
./emqx/bin/emqx foreground
```