# `gdal dataset copy`

Added in version 3.12.

Copy files of a dataset

gdal dataset copy creates a copy of the dataset file(s), including potential side-car/associated files.

## Synopsis

    Usage: gdal dataset copy [OPTIONS] <SOURCE> <DESTINATION>

    Copy files of a dataset.

    Positional arguments:
      --source <SOURCE>            Source dataset name [required]
      --destination <DESTINATION>  Destination dataset name [required]

    Common Options:
      -h, --help                   Display help message and exit
      --json-usage                 Display usage as JSON document and exit
      --config <KEY>=<VALUE>       Configuration option [may be repeated]

    Options:
      --overwrite                  Whether overwriting existing output is allowed

    Advanced Options:
      -f, --format <FORMAT>        Dataset format

## Options

--source <FILENAME>

  Source file name or directory name. Required.

--destination <FILENAME>

  Destination file name or directory name. Required.

-f, ---format <FORMAT>

  Dataset format. Helps if automatic detection does not work.

--overwrite

  Allow program to overwrite existing target file or dataset. Otherwise, by default, gdal errors out if the target file or dataset already exists.

## Examples

### Example 1: Copy a dataset

    $ gdal dataset copy source.tif destination.tif