Skip to main content
Version: v6.0.0 [Falcon]

Accessing MX-UI

The MX-UI is served on port 8080 of the control-plane node. How you reach it depends on whether that node is on your network.

  • Node directly reachable → browse straight to it.
  • Node not reachable (the usual remote case) → bridge the gap with an SSH tunnel.

Both paths end on the same login screen.

Option A — Direct access​

If the control-plane node is reachable from your machine, open:

http://<control-plane-ip>:8080

Replace <control-plane-ip> with the node's hostname or IP. Nothing else to set up.

On the control-plane node itself, the UI also resolves at the friendly hostname:

http://mxui.bubbleran

Option B — SSH tunnel​

When the node is not exposed to your laptop, forward port 8080 over SSH.

Topology​

[ your laptop ]------ ssh -L ------>[ control-plane node :8080 ]
localhost:8080 MX-UI

Step by step​

1. From your laptop, open the tunnel to the control-plane node:

ssh -L 8080:localhost:8080 <user>@<ip-address>
  • Maps localhost:8080 (laptop) → localhost:8080 on the control-plane node, where the MX-UI is served.
  • Keep this session open.

2. Open the GUI:

http://localhost:8080

Logging in​

Either path lands on the login screen. Enter your username and password, then select Sign in. On success you land on the Dashboard.

Default credentials:

  • User: admin
  • Password: bubbleran

Login

warning

Change the default password after the first login (see Settings).

Settings​

Route: /settings (account menu in the header → Settings)

  • Account & Security — Change Password: enter the current password and a new one (minimum 8 characters), then confirm. It takes effect immediately for the next sign-in, with no restart. Wrong attempts are rate-limited.
  • About — the console's version and license notice.

Settings

The header also has a light / dark theme toggle; your choice is remembered in the browser.