# Install EMQX Edge on Linux

This page guides you through the installation of EMQX Edge on a Linux system. You can install EMQX Edge using one of the following methods:

- **Install via Script**: The quickest way to get started. A single `curl` command downloads and installs the latest EMQX Edge release automatically.
- **Install via Package**: Download and extract the package manually for full control over the version and placement.

## Install via Script

The install script automatically detects your system architecture, downloads the latest EMQX Edge release, verifies its checksum, and installs it to `/opt/emqx-edge`.

Run the following command:

```bash
curl -fsSL emqx.sh/edge | bash
```

Once the installation is complete, start EMQX Edge:

```bash
source /etc/profile.d/emqx-edge.sh && emqx-edge start
```

> **Note:** This script only works on Linux. It requires `curl`, `unzip`, `grep`, and `awk` to be installed, and needs `sudo` access to write to `/opt/emqx-edge` and `/etc/profile.d/`.

### Install a Specific Version

To install a specific version, set the `EMQX_VERSION` environment variable:

```bash
curl -fsSL emqx.sh/edge | EMQX_VERSION=v1.4.0 bash
```

### Customize the Installation Directory

To change the installation directory, set the `INSTALL_DIR` environment variable:

```bash
curl -fsSL emqx.sh/edge | INSTALL_DIR=/custom/path bash
```

## Install via Package

Visit the [EMQX Edge download page](https://www.emqx.com/en/try?tab=self-managed) to obtain the appropriate Linux package for your system architecture.

**Installation Example (arm64)**

The following steps demonstrate how to install EMQX Edge version v1.4.0 on an arm64 device:

1. Extract the package:

   ```bash
   unzip ./emqx-edge-1.4.0-linux-arm64.zip
   ```

2. Navigate to the extracted directory, and start EMQX Edge:

   ```bash
   ./emqx-edge start
   ```

## Access the EMQX Edge Dashboard

EMQX Edge includes a built-in web-based Dashboard that allows you to monitor system status, manage configurations, and configure required features.

1. Open a web browser and visit `http://localhost:8081` (`localhost` can be substituted with your IP address).
2. Log in to the EMQX Edge Dashboard with default credentials:
   - **Username**: `admin`
   - **Password**: `public`

![dashboard_monitor](./assets/dashboard_monitor.png)