AzCopy v10 configuration settings (Azure Storage)
AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. This article contains a list of environment variables that you can use to configure AzCopy v10.
If you're looking for content to help you get started with AzCopy, see Get started with AzCopy.
AzCopy v10 environment variables
The following table describes each environment variable and provides links to content that can help you use the variable.
|AWS_ACCESS_KEY_ID||Amazon Web Services access key. Provides a key to authorize with Amazon Web Services.Copy data from Amazon S3 to Azure Storage by using AzCopy|
|AWS_SECRET_ACCESS_KEY||Amazon Web Services secret access key Provides a secret key to authorize with Amazon Web Services. Copy data from Amazon S3 to Azure Storage by using AzCopy|
|AZCOPY_ACTIVE_DIRECTORY_ENDPOINT||The Azure Active Directory endpoint to use. This variable is only used for auto login, please use the command line flag instead when invoking the login command.|
|AZCOPY_AUTO_LOGIN_TYPE||Set this variable to
|AZCOPY_BUFFER_GB||Specify the maximum amount of your system memory you want AzCopy to use when downloading and uploading files. Express this value in gigabytes (GB). See Optimize memory use|
|AZCOPY_CACHE_PROXY_LOOKUP||By default AzCopy on Windows will cache proxy server lookups at hostname level (not taking URL path into account). Set to any other value than 'true' to disable the cache.|
|AZCOPY_CONCURRENCY_VALUE||Specifies the number of concurrent requests that can occur. You can use this variable to increase throughput. If your computer has fewer than 5 CPUs, then the value of this variable is set to
|AZCOPY_CONCURRENT_FILES||Overrides the (approximate) number of files that are in progress at any one time, by controlling how many files we concurrently initiate transfers for.|
|AZCOPY_CONCURRENT_SCAN||Controls the (max) degree of parallelism used during scanning. Only affects parallelized enumerators, which include Azure Files/Blobs, and local file systems.|
|AZCOPY_CONTENT_TYPE_MAP||Overrides one or more of the default MIME type mappings defined by your operating system. Set this variable to the path of a JSON file that defines any mapping. Here's the contents of an example JSON file:
|AZCOPY_DEFAULT_SERVICE_API_VERSION||Overrides the service API version so that AzCopy could accommodate custom environments such as Azure Stack.|
|AZCOPY_DISABLE_HIERARCHICAL_SCAN||Applies only when Azure Blobs is the source. Concurrent scanning is faster but employs the hierarchical listing API, which can result in more IOs/cost. Specify 'true' to sacrifice performance but save on cost.|
|AZCOPY_JOB_PLAN_LOCATION||Overrides where the job plan files (used for progress tracking and resuming) are stored, to avoid filling up a disk.|
|AZCOPY_LOG_LOCATION||Overrides where the log files are stored, to avoid filling up a disk.|
|AZCOPY_MSI_CLIENT_ID||The client ID of a user-assigned managed identity. Use when
|AZCOPY_MSI_OBJECT_ID||The object ID of the user-assigned managed identity. Use when
|AZCOPY_MSI_RESOURCE_STRING||The resource ID of the user-assigned managed identity. See Authorize without a secret store|
|AZCOPY_PACE_PAGE_BLOBS||Should throughput for page blobs automatically be adjusted to match Service limits? Default is true. Set to 'false' to disable|
|AZCOPY_PARALLEL_STAT_FILES||Causes AzCopy to look up file properties on parallel 'threads' when scanning the local file system. The threads are drawn from the pool defined by AZCOPY_CONCURRENT_SCAN. Setting this to true may improve scanning performance on Linux. Not needed or recommended on Windows.|
|AZCOPY_SHOW_PERF_STATES||If set, to anything, on-screen output will include counts of chunks by state|
|AZCOPY_SPA_APPLICATION_ID||The application ID of your service principal's app registration. Use when
|AZCOPY_SPA_CERT_PASSWORD||The password of a certificate. Use when
|AZCOPY_SPA_CERT_PATH||The relative or fully qualified path to a certificate file. Use when
|AZCOPY_SPA_CLIENT_SECRET||The client secret. Use when
|AZCOPY_TENANT_ID||The Azure Active Directory tenant ID to use for OAuth device interactive login. This variable is only used for auto login, please use the command line flag instead when invoking the login command.|
|AZCOPY_TUNE_TO_CPU||Set to false to prevent AzCopy from taking CPU usage into account when autotuning its concurrency level (for example, in the benchmark command).|
|AZCOPY_USER_AGENT_PREFIX||Add a prefix to the default AzCopy User Agent, which is used for telemetry purposes. A space is automatically inserted.|
|GOOGLE_APPLICATION_CREDENTIALS||The absolute path to the service account key file Provides a key to authorize with Google Cloud Storage. Copy data from Google Cloud Storage to Azure Storage by using AzCopy (preview)|
|HTTPS_PROXY||Configures proxy settings for AzCopy. Set this variable to the proxy IP address and proxy port number. For example,
Configure proxy settings
To configure the proxy settings for AzCopy, set the
HTTPS_PROXY environment variable. If you run AzCopy on Windows, AzCopy automatically detects proxy settings, so you don't have to use this setting in Windows. If you choose to use this setting in Windows, it will override automatic detection.
|Windows||In a command prompt use:
In PowerShell use:
Currently, AzCopy doesn't support proxies that require authentication with NTLM or Kerberos.
Bypassing a proxy
If you are running AzCopy on Windows, and you want to tell it to use no proxy at all (instead of auto-detecting the settings) use these commands. With these settings, AzCopy will not look up or attempt to use any proxy.
|Windows||Command prompt (CMD)||
On other operating systems, simply leave the HTTPS_PROXY variable unset if you want to use no proxy.