> For the complete documentation index, see [llms.txt](https://docs.quadratichq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.quadratichq.com/connections/cockroachdb.md).

# CockroachDB

## CockroachDB

You can create your CockroachDB connection from either your team's dashboard or directly inside a spreadsheet. From the Dashboard, navigate to the Connections menu item. Or from inside a spreadsheet, press `/` and then Manage connections.

CockroachDB is PostgreSQL-compatible, so the connection details mirror a Postgres connection.

### Connection details

To connect to your CockroachDB cluster, enter the following parameters in the Team connections modal:

* **Connection name** — the display name for your connection across Quadratic and your team
* **Hostname** — your cluster's host (for CockroachDB Cloud, copy it from the cluster's **Connect** dialog)
* **Port** — typically `26257`
* **Database** — the database name
* **Username / Password** — credentials with the access you want available in Quadratic

CockroachDB Cloud clusters require SSL; Quadratic connects securely by default.

### IP allow-list

{% hint style="info" %}
You must whitelist both Quadratic IP addresses to make connections, which are:\
44.240.255.40\
54.68.134.35

* These IP addresses do not apply to self-hosted instances
  {% endhint %}

Once you've made your connection, you can use it directly in spreadsheets to read data to your spreadsheets. Learn how in SQL - getting started.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.quadratichq.com/connections/cockroachdb.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.