---
title: tb connection
meta:
   description: Manage your data connections from the terminal.
---

# tb connection

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

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

## Subcommands

The following subcommands are available:

{% table %}
  * Subcommand
  * Description
  ---
  * create TYPE
  * Create a new connection. Supported values are: `kafka`, `gcs`, and `s3`.
  ---
  * ls
  * Lists all connections in the project. 
{% /table %}

## tb connection ls

Lists connections.

{% table %}
  * Option
  * Description
  ---
  * --service TEXT
  * Filter by service.
{% /table %}

## Environment support

{% table %}
  * 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.
{% /table %}