README.md

RocketMQ-Rust Dashboard (Tauri)

A RocketMQ-Rust desktop dashboard built with Tauri, React, and Rust.

Features

• Native desktop packaging with a web UI
• Rust backend and React frontend
• Local embedded authentication with SQLite
• Argon2 password hashing
• Forced bootstrap password change on first login
• In-memory session management with session restore while the backend process remains alive

Authentication Quick Start

On first startup the application bootstraps a local administrator account:

• Username: admin
• Initial password:
  • ROCKETMQ_DASHBOARD_INIT_PASSWORD, if provided
  • otherwise admin123

After the first successful login, the user must change the password before entering the dashboard.

Authentication data is stored in:

• Windows: %APPDATA%\com.rocketmq-rust.dashboard\dashboard.db
• macOS: ~/Library/Application Support/com.rocketmq-rust.dashboard/dashboard.db
• Linux: ~/.config/rocketmq-rust-dashboard/dashboard.db

For more detail, see doc/AUTH_CONFIG.md.

Development

Prerequisites

• Rust toolchain
• Node.js and npm
• Tauri platform prerequisites for your OS

Install

npm install

Run in development mode

npm run tauri dev

If you prefer Cargo:

cargo install tauri-cli
cargo tauri dev

Build

npm run build
npm run tauri build

If you prefer Cargo for packaging:

cargo install tauri-cli
cargo tauri build

Notes:

• npm run build only builds the frontend assets.
• npm run tauri build or cargo tauri build produces the desktop package.
• cargo build inside src-tauri only builds the Rust backend and does not generate the installer bundle.

Verification

Backend:

cd src-tauri
cargo test

Frontend:

npm run build

Reset local auth

To reset the local administrator account:

1. Stop the application.
2. Delete dashboard.db from the application config directory.
3. Restart the application.
4. Sign in again with the bootstrap password source.

License

Licensed under either of:

• Apache License, Version 2.0
• MIT license