Skip to main content

​
Description

The dvc version command displays the installed DVC version along with detailed system and environment information. This is useful for debugging, reporting issues, and verifying your installation.

​
Usage

dvc version
Alias: dvc doctor 
dvc version

​
Arguments

This command takes no arguments.

​
Options

This command has no options.

​
Example Output

$ dvc version

DVC version: 3.48.2 (pip)
---------------------------------
Platform: Python 3.11.7 on Linux-5.15.0-91-generic-x86_64-with-glibc2.35
Supports:
    azure (adlfs = 2024.2.0, knack = 0.11.0, azure-identity = 1.15.0),
    gdrive (pydrive2 = 1.19.0),
    gs (gcsfs = 2024.2.0),
    http (aiohttp = 3.9.3, aiohttp-retry = 2.8.3),
    https (aiohttp = 3.9.3, aiohttp-retry = 2.8.3),
    oss (ossfs = 2023.12.0),
    s3 (s3fs = 2024.2.0, boto3 = 1.34.51),
    ssh (sshfs = 2024.2.0),
    webdav (webdav4 = 0.9.8),
    webdavs (webdav4 = 0.9.8)
Cache types: hardlink, symlink
Cache directory: ext4 on /dev/sda1
Caches:
    local: md5
Remotes:
    azure, gdrive, gs, http, https, oss, s3, ssh, webdav, webdavs
Repo: dvc (no_scm), git

​
Information Displayed

The dvc version command provides comprehensive diagnostic information:
The installed version of DVC and installation method (pip, conda, binary, etc.).
DVC version: 3.48.2 (pip)
Python version, operating system, and architecture.
Platform: Python 3.11.7 on Linux-5.15.0-91-generic-x86_64-with-glibc2.35
Available storage protocol support and their dependency versions.
  • azure - Azure Blob Storage
  • gdrive - Google Drive
  • gs - Google Cloud Storage
  • http/https - HTTP(S) sources
  • oss - Alibaba Cloud OSS
  • s3 - Amazon S3
  • ssh - SSH/SFTP
  • webdav/webdavs - WebDAV protocol
Available file link types for cache.
  • hardlink - Hard links (default)
  • symlink - Symbolic links
  • reflink - Copy-on-write links (if filesystem supports)
  • copy - Full file copies
Filesystem type and location of cache directory.
Cache directory: ext4 on /dev/sda1
Hash algorithms available for cache.
Caches: local: md5
Configured remote storage types.
Remotes: azure, gdrive, gs, http, https, oss, s3, ssh, webdav, webdavs
Repository type and SCM information.
Repo: dvc (no_scm), git

​
Use Cases

Version Check

Verify you have the correct DVC version installed.

Bug Reports

Include full version output when reporting issues to help maintainers reproduce problems.

Feature Availability

Check which storage protocols and features are available in your installation.

Environment Debugging

Diagnose environment issues, dependency conflicts, or missing features.

​
Examples

​
Check DVC Version

$ dvc version | head -n 1

DVC version: 3.48.2 (pip)

​
Verify Storage Support

Check if a specific storage protocol is supported: 
$ dvc version | grep -A 10 "Supports:" | grep s3

    s3 (s3fs = 2024.2.0, boto3 = 1.34.51),
If a storage protocol is missing, you may need to install additional dependencies:
pip install 'dvc[s3]'      # For S3
pip install 'dvc[gs]'      # For Google Cloud Storage
pip install 'dvc[azure]'   # For Azure
pip install 'dvc[ssh]'     # For SSH
pip install 'dvc[all]'     # For all storage types

​
Check Python Version

$ dvc version | grep Platform

Platform: Python 3.11.7 on Linux-5.15.0-91-generic-x86_64-with-glibc2.35

​
Save Version Info to File

Useful for bug reports or documentation: 
$ dvc version > dvc-version-info.txt

​
Version Update Check

When running dvc version, DVC may also check for updates: 
┌──────────────────────────────────────────────────────┐
│ Update available 3.48.2 → 3.49.0                     │
│ Run `pip install --upgrade dvc` to upgrade           │
└──────────────────────────────────────────────────────┘
You can disable update checks with:
dvc config core.check_update false

​
Troubleshooting

​
Missing Storage Support

If you see limited storage support: 
Supports:
    http (aiohttp = 3.9.3, aiohttp-retry = 2.8.3),
    https (aiohttp = 3.9.3, aiohttp-retry = 2.8.3)
Solution: Install storage-specific extras: 
pip install 'dvc[s3,gs,azure,ssh]'

​
Version Mismatch

If you’re running a different version than expected: 
# Check where DVC is installed
which dvc

# Upgrade to latest version
pip install --upgrade dvc

# Or install specific version
pip install dvc==3.48.2

​
Import Errors

If DVC fails to import storage dependencies: 
ERROR: failed to load 's3' support
Solution: Reinstall with required extras: 
pip install --force-reinstall 'dvc[s3]'

​
Installation Methods

The version output shows how DVC was installed: 
pip install dvc
# Or with extras:
pip install 'dvc[all]'
Output: DVC version: 3.48.2 (pip)
  • dvc config - Configure DVC settings including update checks
  • dvc init - Initialize DVC repository
  • pip install --upgrade dvc - Upgrade DVC to the latest version

​
Additional Resources

Release Notes

View changelog and new features for each version

Installation Guide

Detailed installation instructions for all platforms

Report Issues

Report bugs or request features

Community

Get help from the DVC community

Build docs developers (and LLMs) love

Get started for freeTalk to us