> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bytebase.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Step 4: Add an Instance

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

## Prerequisites

* **Workspace Admin** or **Workspace DBA** role

## Add instance

<Info>
  If you choose to use sample data during onboarding, Bytebase will start two embedded sample PostgreSQL instances accessible from `/tmp:8083` and `/tmp:8084`.
</Info>

Go to **Instances** and click **Create**. Pick the database engine, then fill in the **Basic Info** — the instance name and the environment it belongs to.

<img src="https://mintcdn.com/dbx/Olg7uzFG0_N9GcnI/content/docs/get-started/step-by-step/add-an-instance/bb-instances.webp?fit=max&auto=format&n=Olg7uzFG0_N9GcnI&q=85&s=35cdbc8229bac47e82a48caadb85ec1d" alt="Choose engine and fill basic info" width="1400" height="992" data-path="content/docs/get-started/step-by-step/add-an-instance/bb-instances.webp" />

Next, scroll down to the **Connection** section and enter how Bytebase reaches the database.

<img src="https://mintcdn.com/dbx/Olg7uzFG0_N9GcnI/content/docs/get-started/step-by-step/add-an-instance/bb-instances-2.webp?fit=max&auto=format&n=Olg7uzFG0_N9GcnI&q=85&s=1362aa7209456b58239b0ddf8f35695e" alt="Configure the connection" width="1400" height="776" data-path="content/docs/get-started/step-by-step/add-an-instance/bb-instances-2.webp" />

For **Host or Socket**, if you run Bytebase inside Docker and connect to a database on the same host, use `host.docker.internal`. Check out [Instance Connection Configuration](/get-started/instance) for the detailed guide.