Edit on GitHub

remote add

Add a new dvc remote to the project configuration.

You may also need dvc remote modify to provide credentials and/or configure other remote parameters. See Remote storage configuration for more information.

Synopsis

usage: dvc remote add [-h] [--global | --system | --project | --local]
                      [-q | -v] [-d] [-f]
                      name url

positional arguments:
  name           Name of the remote.
  url            (See supported URLs in the examples below.)

Description

Registers a remote storage location to save data files (besides the cache) and optionally sets it as the --default remote. DVC remotes can point to a cloud storage service, an SSH server, network-attached storage, or even a directory in the local file system.

A dvc remote default is expected by dvc push, dvc pull, dvc status, dvc gc, and dvc fetch unless their --remote (-r) option is used.

The remote name (required) is used to identify the remote and must be unique. DVC will determine the storage type based on the provided url (also required), a URL or path for the location.