GitVersion calculates semantic versions from your Git history. Start with a local repository, connect your build pipeline, or look up a setting.
Calculate your first version
Install GitVersion and understand its output.
Use GitVersion in CI
Prepare your checkout and pass versions to later build steps.
Configure your workflow
Choose defaults and customize GitVersion.yml.
Explore the documentation
- Getting started — installation, prerequisites, and a first calculation.
- Guides — workflows, integrations, and practical tasks.
- Concepts — how versions are calculated.
- Reference — arguments, settings, and output variables.
- Troubleshooting — diagnose unexpected results.
- Upgrading — changes between GitVersion versions.
These pages describe v7 development. Check your installed version with dotnet-gitversion --version and consult the v6 to v7 migration guide before applying examples to an older installation.