First Login Guide

Last Updated: September 28, 2026
Estimated Reading Time: 4 minutes

Overview

This guide shows the steps for your first login to cmdbx. It starts with the email from cmdbx and ends at the Overview page.

Before You Begin

You must have an email from [email protected]. The email is one of these two types:

  • A team invitation. Its button is Accept Invitation & Join and the name of your organization.
  • A welcome email for a new tenant. Its button is Set Up Your Account.

An invitation link expires after 7 days by default. Your administrator can set a different period of up to 30 days. If your link expired, ask your administrator to send a new invitation.

Step 1: Open the Link

  1. Open the email from [email protected].
  2. Click the button in the email.
  3. cmdbx opens the sign-in page.

Step 2: Sign In

cmdbx uses Supabase authentication. On the sign-in page:

  1. Make sure that your email address is correct.
  2. Select one option:
    • Password: enter your password and click Sign In.
    • Magic Link: click Magic Link, send the link, and open it from your email.
  3. If cmdbx asks you to set a password, set one.

Step 3: Open Your Tenant

cmdbx opens your organization at this address:

https://cmdbx.com/[your-tenant]

Managed service provider users open the MSP dashboard instead. From there, they open each customer tenant.

Step 4: Connect ServiceNow (Administrators Only)

If you are the first user or an administrator, cmdbx can show the onboarding wizard. It asks you to connect ServiceNow:

  1. Enter the ServiceNow instance URL, for example https://dev12345.service-now.com.
  2. Enter read-only credentials.
  3. Test the connection.
  4. Start the first sync.

If you are not an administrator, skip this step. Your administrator configures the ServiceNow connection. For full instructions, see Connect ServiceNow.

Step 5: Explore the Overview

After you sign in, cmdbx shows the Overview. It contains:

  • A summary row: CMDB health, monitored CIs, at-risk CIs, the weakest health domain, workflow items in progress, and the time since the last sync.
  • CMDB health score: the overall score (0-100) and the average for each health component.
  • Next best actions: a short list of the most useful next steps.
  • Findings and CMDB Activity: open issues and the changes from the last sync.
  • Health distribution, Remediation pipeline, Health trend, and Criticality vs health.

The health score uses these levels:

  • Excellent (90-100)
  • Good (75-89)
  • Fair (50-74)
  • Poor (25-49)
  • Critical (0-24)

Common First-Time Questions

Q: Why can I not see any data?

A: Your first sync can still be in progress. Examine the sync status in the top bar. The sync time depends on the size of your CMDB. See Sync Problems if the sync does not complete.

Q: Where is the navigation menu?

A: Click Workspaces in the top-left corner. See Interface Overview.

Q: How do I change my password?

A: Open the account menu in the top-right corner. Click Change Password. You can also use the password reset option on the sign-in page.

Q: What must I do first?

A: We recommend these steps:

  1. Review the health score and the next best actions on the Overview.
  2. Go to CMDB > CI Health to see the CIs in each health status.
  3. Go to Dependency Map to explore your topology.
  4. Go to Remediation to review the open issues.

Troubleshooting

"Your link has expired"

Your invitation link expired. Ask your administrator to send a new invitation.

"Unable to access this tenant"

Your account possibly does not have access to this organization. Ask your administrator to check your access.

"Authentication failed"

Clear your browser cache and cookies. Then try again. If the problem continues, contact [email protected].

Next Steps

  1. Interface Overview: learn the layout
  2. Health Dashboard: understand your metrics
  3. Dependency Map: explore your topology
  4. Remediation: fix CMDB problems