Add an Instance

Database Instance or simply Instance models after a single database server which is usually accessed via a host:port address. A typical database instance could be your on-premises MySQL instance, an AWS RDS instance etc. Each Database Instance belongs to an Environment.

Prerequisites

  • Workspace Admin or Workspace DBA role

  • Bytebase provides two embedded sample PostgreSQL instances. You may add your own or add a local MySQL instance.

Add instance

Go to Instances and Add Instance.

bb-instances

bb-instances-2

For Host or socket, the screenshot assumes you run Bytebase inside Docker and try to connect to a database instance on the same host, thus it uses host.docker.internal. Check out Instance Connection Configuration for the detailed guide.

Sync instance

After instance is added, click Sync Now to synchronize the instance schema such as its containing databases to Bytebase.

bb-instance-sync

By default, Bytebase doesn't automatically sync the instance schema. You can set a Scan Interval to ask Bytebase to sync the schema periodically.

Edit this page on GitHub

Subscribe to Newsletter

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