Connect a Source

A source is a named connection to a provider. --source postgres plus "sourceKey": "warehouse" creates the identifier postgres://warehouse.

Basic Flow

Pick the provider.
Terminal window
```
onequery source connect --help
```
Ask for provider-specific setup guidance.
Terminal window
```
onequery source connect --source postgres
```

Build the input payload with a read-only credential.

{
  "sourceKey": "warehouse",
  "credentials": {
    "host": "db.example.com",
    "port": 5432,
    "database": "app",
    "username": "onequery_readonly",
    "password": "<read-only-password>",
    "sslMode": "require"
  }
}

Connect the source.

onequery source connect --source postgres \
  --input '{"sourceKey":"warehouse","credentials":{"host":"db.example.com","port":5432,"database":"app","username":"onequery_readonly","password":"<read-only-password>","sslMode":"require"}}'

Confirm the source appears.
Terminal window
```
onequery source list
```

Credential Guidance

Prefer read-only users or provider tokens.
Create separate OneQuery sources for production, staging, and customer data.
Rotate provider credentials outside the agent runtime.
Do not paste source credentials into prompts or task descriptions.

Provider Families

Use the integration pages for provider-specific patterns: