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

# Creating an Instance

> Provision a new managed PostgreSQL database on Nearbase

## Overview

Creating a Nearbase instance takes 2–5 minutes. You'll select a region, PostgreSQL version, instance class, and storage size — then complete checkout. Once provisioned, you receive a connection string and your database is immediately ready.

## Steps

<Steps>
  <Step title="Open the Console">
    Go to [console.nearbase.dev](https://console.nearbase.dev) and navigate to
    **Instances** in the sidebar. Click **New Instance**.
  </Step>

  <Step title="Choose a Region">
    Select the region closest to your application servers or end users for the
    lowest latency. See [Regions](/regions) for the full list and compliance
    information.

    <Tip>
      If you're unsure, **Singapore** (`ap-southeast-1`) is a good default for
      Southeast Asia. **Tokyo** (`ap-northeast-1`) is best for Japan and East
      Asia workloads.
    </Tip>
  </Step>

  <Step title="Select a PostgreSQL Version">
    Choose the PostgreSQL major version. We recommend using the latest available
    version unless you have a compatibility requirement.
  </Step>

  <Step title="Choose an Instance Class">
    Select the CPU and memory configuration that fits your workload. See
    [Instance Classes](/instances/instance-classes) for a breakdown of all
    available tiers and how to choose between them.
  </Step>

  <Step title="Set Storage Size">
    Choose the initial storage size in GB. Storage is backed by high-performance
    cloud disk (`general_essd`) by default.

    <Note>
      You can scale storage up later without downtime, but you cannot reduce it.
      Start with enough room for your data plus anticipated growth.
    </Note>
  </Step>

  <Step title="Review and Checkout">
    Review the monthly price, then proceed to checkout. Payment is deducted from
    your [account balance](/billing/balance-and-credits) first. If your balance
    is insufficient, the remainder is charged to your saved card.

    Your instance enters **Provisioning** status and is typically ready within
    2–5 minutes. You'll see it switch to **Running** in the console.
  </Step>
</Steps>

## After Provisioning

Once your instance is **Running**:

* The **Overview** tab shows your full connection string.
* Connect with any PostgreSQL client — see [Connecting to Your Database](/connecting).
* Your IP address needs to be in the allowlist to connect. By default, all IPs (`0.0.0.0/0`) are allowed. Restrict this in the [Security tab](/instances/security).

## Instance Limits

There is no hard limit on the number of instances per organization. Each instance is billed as a separate monthly subscription.