Last update: 2025-12-18T09:52:50.000Z
Content:
---
title: "tb connection · Tinybird Docs"
theme-color: "#171612"
description: "Manage your data connections from the terminal."
inkeep:version: "forward"
---




# tb connection [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-connection#tb-connection)

Copy as MD Manage your data connections. Global options apply to this command. See [Global options](/docs/forward/dev-reference/commands/global-options).

Connections are configured through .connection files. See [Connection files](/docs/forward/dev-reference/datafiles/connection-files).

## Subcommands [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-connection#subcommands)

The following subcommands are available:

| Subcommand | Description |
| --- | --- |
| create TYPE | Create a new connection. Supported values are: `kafka`  , `gcs`   , and `s3`  . |
| ls | Lists all connections in the project. |

## tb connection ls [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-connection#tb-connection-ls)

Lists connections.

| Option | Description |
| --- | --- |
| --service TEXT | Filter by service. |

## Environment support [¶](https://www.tinybird.co/docs/forward/dev-reference/commands/tb-connection#environment-support)

| Environment | Supported | Description |
| --- | --- | --- |
| `--local` | ✓ Yes (default) | Manages connections in Tinybird Local. |
| `--cloud` | ✓ Yes | Manages connections in Tinybird Cloud. |
| `--branch=BRANCH_NAME` | ✓ Yes | Manages connections in a branch. |


