Product docs

Getting Started

Welcome to ArchiBot

Learn what ArchiBot Console is for, how first sign-in works, where you land, which guide covers each Console area, and what is safe to share.

Customer adminsCustomer membersPlatform operators

Last updated

ArchiBot Console with the navigation rail (Build, Ship, Data and Team groups) beside My Workspaces, signed in as a synthetic team member, on safe example data.
Safe example data: the rail groups the areas your role can open; the footer shows who is signed in.

ArchiBot Console is where your team sets up its account, creates and opens ArchiBot workspaces, plans and reviews changes, shares files with ArchiBot, and follows usage and billing. Normal work never needs service tokens, cluster access or internal service addresses.

Sign in for the first time

  1. Open the Console address ISM gave you.
  2. Choose Sign in to Console, then your organization’s provider (often Login via IdP). New organizations choose Create a new organization, and invited people choose Accept an invitation.
  3. Sign in with your work identity.

Details and recovery steps: Sign-in, members and access roles.

Where you land

  • Accounts that are set up for Chat with credits available open Chat.
  • Everyone else lands on My Workspaces.
  • A login that isn’t on a team yet goes to Account Setup (or, for operators, to Access) until setup is done.

Console areas and their guides

The navigation groups areas under Build, Ship, Data and Team, and only shows what your role can open.

AreaAddressWho sees itGuide
Chat/chatEveryoneArchiBot Chat getting started
My Workspaces/workspacesEveryone with a teamManage workspaces
New workspace (Create)/createEveryone with a teamCreate a workspace
Opening a workspace link/w/<id>Anyone who can use that workspaceOpen a workspace
Backups/backupsEveryone with a teamBackups and restore sources
Design/designEveryone with a teamDesign
Environments/environmentsEveryone with a teamEnvironments and CI & Review
CI & Review/ci-reviewEveryone with a teamEnvironments and CI & Review
Bots/botsTeam admins, platform rolesConsole Bots
Operations/operationsTeam admins, platform rolesOperations center
Shared Drive/shared-driveEveryone with a teamShared Drive
Catalog/catalogTeam admins, platform rolesProduct Catalog
Members & access/account, /account/access or /accessEveryoneAccess roles, Customer admin setup, Tenant admin
Usage & billing/analytics, /account/billingEveryone with a team (billing: admins)Usage and analytics, Billing
Settings/settingsEveryone with a teamSettings
Workspace Help/workspace-helpTeam admins, platform rolesWorkspace Help
Billing Help/billing-helpPlatform operatorsBilling Help

Workspace Help and Billing Help are not in the rail; open them by address. Help (i) buttons in Console have an Open documentation link to the matching section of these guides, in the language Console is set to. Pages that are not translated yet show English. Console sites used for testing link to the test copy of these docs.

The rail footer has the Console language selector, Feedback (Sending feedback), the theme toggle, Collapse navigation, your account chip and sign-out. The account chip shows the role Console is using: Team admin, Team member, Team viewer, Platform operator or Platform admin. Some operator accounts can View as a team role to preview what a team sees, and Stop preview ends it.

On a phone

  • A bottom bar replaces the rail. It shows Chat, Workspaces, Design, Catalog (admins), Team and Usage (or Billing), depending on your role. Expand navigation at the top opens the full navigation as a panel.
  • Console areas work on a phone, including Settings and the Access admin pages. Wide tables become labelled cards or scroll sideways inside their own box, most dialogs open as full-width sheets from the bottom of the screen, and long forms keep their main button pinned to the bottom while the form is on screen.
  • Each guide has an On a phone section for its area.

My Workspaces on a phone with the top bar (Expand navigation, theme and profile) and the bottom bar with Chat, Workspaces, Design, Team and Usage, on safe example data.

The full navigation open as a panel over My Workspaces on a phone, after choosing Expand navigation, on safe example data.

Safe information sharing

Share company contacts, repository locations, backup choices, non-secret identity-provider details, role expectations and visible Console error messages. Never share passwords, private keys, API keys, cookies, tokens, invitation links, webhook secrets, database URLs, payment details, cluster credentials, or screenshots that show them.

Quick recovery

SymptomFirst stepNext
An expected area is missingCheck your role on the account chip, then sign out and back in.Access roles
An invitation failsSign in with the invited email address.Access roles
Create is blockedRead the Create Summary’s “N things left”.Create a workspace
Anything elseNote the page, time and error text.Troubleshooting

Done When

  • You can sign in through the expected identity provider.
  • The navigation matches your role.
  • You know which guide covers the Console area you need.