Skip to content
MACHHUB MACHHUB MACHHUB
Contribute to this page

First login & bootstrap

After MACHHUB is installed and running, you need a user account to sign in to the console.

The admin domain

Section titled “The admin domain”

MACHHUB always has a built-in administrative domain, domains:machhub_admin. This is the default tenant for requests that don’t specify a Domain header, and where administration (users, groups, applications) happens.

Two group names are reserved:

  • superuser — bypasses all permission checks.
  • member — the baseline group.

Sign in for the first time

Section titled “Sign in for the first time”

MACHHUB provisions an administrator account when it first runs. The default credentials are username admin and password admin. Once you’re in, you can add more users and groups from the console.

sequenceDiagram
  participant You
  participant Console
  participant EDGE as MACHHUB Platform
  You->>Console: open the console URL
  You->>Console: enter username + password
  Console->>EDGE: POST /auth/login
  EDGE-->>Console: { success: true, tkn }
  Console-->>You: redirect to Home (token stored in the browser)
  1. Open the console in a browser.
  2. Enter your username and password and Sign In.
  3. You land on the Home dashboard.

From here, continue with Using the Console — create collections, build your Unified Namespace, and add users and groups.