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

# PostgreSQL source

> Configure PostgreSQL as a live MantrixFlow source connection.

PostgreSQL is the live source connector documented for the current MantrixFlow app.

## Required access

Use a database user with read access to the source schemas and tables you want to sync.

For a first pipeline, start with one table such as `public.orders`.

## Connection fields

| Field           | Notes                                   |
| --------------- | --------------------------------------- |
| Connection Name | A human-readable name shown in the app  |
| Host            | Database host or provider endpoint      |
| Port            | Usually `5432`                          |
| Database        | Database name                           |
| Username        | Source user                             |
| Password        | Source user password                    |
| Schema          | Usually `public` for first tests        |
| SSL Mode        | Use `require` for most hosted databases |

## Setup flow

1. Open **Connections**.
2. Click **+ New Connection**.
3. Set role to **Source**.
4. Choose **PostgreSQL**.
5. Fill the form.
6. Click **Test Connection**.
7. Save only after the test succeeds.

## Builder behavior

After a pipeline shell is created, the Source node can:

* test the connection again
* discover source schemas and tables
* include selected streams as `schema.table`
* preview rows for the active stream

Selected streams are persisted as strict source stream configs, including the staging table name such as `public__orders`.