---
title: tb copy
meta:
    description: Manage copy pipes in your Tinybird project
---

# tb copy

Manages copy pipes. Global options apply to this command. See [Global options](/forward/dev-reference/commands/global-options).

The following subcommands are available:

{% table %}
  * Subcommand
  * Description
  ---
  * ls
  * Lists all the copy pipes.
  ---
  * run [OPTIONS] PIPE_NAME_OR_ID
  * Runs a copy job.
  ---
  * pause PIPE_NAME_OR_ID
  * Pauses a copy job.
  ---
  * resume PIPE_NAME_OR_ID
  * Resumes a copy job.
{% /table %}

## tb copy run

Runs a copy job.

{% table %}
  * Option
  * Description
  ---
  * --wait / --no-wait
  * Waits for the copy job to finish.
  ---
  * --mode [append|replace]
  * Defines the copy strategy.
  ---
  * --yes
  * Does not ask for confirmation.
  ---
  * --param TEXT
  * Key and value of the params you want the copy pipe to be called with. For example: tb pipe copy run <my_copy_pipe> --param foo=bar
  ---
  * --on-demand-compute
  * Runs the copy job on a dedicated on-demand compute instance, isolated from your main workspace infrastructure. See [on-demand compute for copy jobs](/forward/work-with-data/optimize/copy-pipes#on-demand-compute-for-copy-jobs).
{% /table %}

## Environment support

{% table %}
  * Environment
  * Supported
  * Description
  ---
  * `--local`
  * ✓ Yes (default)
  * Manages copy pipes locally.
  ---
  * `--cloud`
  * ✓ Yes
  * Manages copy pipes in Tinybird Cloud.
  ---
  * `--branch=BRANCH_NAME`
  * ✓ Yes
  * Manages copy pipes in a branch.
{% /table %}