Quickstart

Register Accounts

After deploying Bytebase successfully, you need to register accounts for your team members.

Create the first admin account

The first registered account after deployment is the admin account and will be granted a Workspace Admin role.

bb-welcome-page

Register a regular account

After the admin account is created, you can register a regular account.

bb-register-normal-user

Log in

After registration, you may log into Bytebase console. bb-login

For Enterprise Plan you may also log into Bytebase using SSO.

Update password

As a Workspace Admin, you can change passwords for the other accounts.

  1. Click Settings on the top bar.
  2. Click Members on the left side bar, and you can see the members page.
  3. Click the name of any member, and you will be redirected to that member’s detail page.
  4. Click Edit, fill in the Password and Confirm, and click Save. The password is updated.

Set up Environments

Environment models after various environments in the development pipeline such as test, staging, prod. Most of the time, there is a 1:1 mapping between Environment and the real environment.

environment

Prerequisites

  • Workspace Admin or Workspace DBA role

Add an environment

  1. Click Environments on the navigation bar, you can see two predefined environments - Test and Prod.
  2. Click Create Environment, enter Environment (name), and choose Rollout Policy** and Database backup schedule policy according to your needs.
  3. Click Create, and you will find the new environment on the right.

Reorder environments

  1. Click Reorder to adjust the environments' order.

Edit an environment

  1. Click Environments on the navigation bar, you can see two predefined environments - Test and Prod.
  2. Choose an existing environment, e.g. Test.
  3. Edit name, rollout policy, database backup schedule policy, and SQL review policy.

Configure a SQL review policy

  1. Click Environments on the navigation bar, you can see two predefined environments - Test and Prod.
  2. Choose an existing environment, e.g. Test.
  3. Click SQL Review > Configure policy.
  4. On Step 1, enter Display name, choose Environment and Template, and click Next.
  5. On Step 2, choose a rule, select its Error Level and click Next.
  6. On Step 3, make sure the preview is OK, and click Confirm and add.
Edit this page on GitHub

Subscribe to Newsletter

By subscribing, you agree with Bytebase's Terms of Service and Privacy Policy.