emqx / emqx-dashboard5

The management console used to monitor and manage EMQX clusters.
42 stars 30 forks source link
broker dashboard emqx mqtt vue3

EMQX 5.0 Dashboard

Build Status

Build Status

EMQX Dashboard is a comprehensive web interface for managing and monitoring EMQX. This intuitive tool allows users to effortlessly oversee EMQX clusters, customize features, and display data visually.

image

🎯 Key Features

🚀 Getting Started

First, ensure that the latest version of EMQX is installed.

Post successful installation, access the EMQX Dashboard by opening http://localhost:18083/ in your browser (replace localhost with the actual IP if not on local machine). By default, the EMQX Dashboard listens on port 18083.

EMQX can operate without the Dashboard. The Dashboard provides a convenient visual interface for users.

🤝 Get Involved

📘 Useful Resources

💻 Local Development

To set up for local development, follow these steps:

  1. Fork the repository and clone your fork:

    git clone https://github.com/your-username/emqx-dashboard5.git
    cd emqx-dashboard5

    Or, clone the original repository directly:

    git clone https://github.com/emqx/emqx-dashboard5.git
    cd emqx-dashboard5
  2. Install the dependencies:

    yarn
  3. To start the development server, run:

    yarn serve
  4. For production compilation and minification:

    yarn build
  5. Lint and fix files:

    yarn lint

    Or, format the code with Prettier:

    yarn format

☁️ Development with Cloud Host

To set up for development with a cloud host:

  1. Create a new .env.development.local file:

    touch .env.development.local
  2. Define your cloud host address in the .env.development.local file:

    HOST_URL=http://your-cloud-host:port/
  3. Start the development server:

    yarn serve

⚙️ Vue.js Customize Configuration

Refer to the Configuration Reference for more information.

After the completion of setup, the CI will run automatically and deploy upon successful execution.