Skip to content

Commit 74f64cf

Browse files
authored
improve installation instruction (#5493)
1 parent be9a954 commit 74f64cf

File tree

4 files changed

+48
-20
lines changed

4 files changed

+48
-20
lines changed

content/docs/install/linux.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -132,13 +132,13 @@ $ sudo yum install dvc
132132

133133
## Install from package
134134

135-
Get the binary package from the big "Download" button on the
136-
[home page](https://dvc.org). Then install it with the following command.
137-
138135
<details id="from-pkg-on-debian-ubuntu">
139136

140137
### On Debian/Ubuntu
141138

139+
[Download the debian package first](https://dvc.org/download/linux-deb/dvc-3.64.1).
140+
Then install it with `apt`:
141+
142142
```cli
143143
$ sudo apt install ./dvc_0.62.1_amd64.deb
144144
```
@@ -149,6 +149,9 @@ $ sudo apt install ./dvc_0.62.1_amd64.deb
149149

150150
### On Fedora/CentOS
151151

152+
[Download the RPM package directly](https://dvc.org/download/linux-rpm/dvc-3.64.1).
153+
Then install it with `yum`:
154+
152155
```cli
153156
$ sudo yum install dvc-0.62.1-1.x86_64.rpm
154157
```

content/docs/install/macos.md

Lines changed: 14 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -24,21 +24,6 @@ Recommended. Requires [Homebrew](https://brew.sh/).
2424
$ brew install dvc
2525
```
2626

27-
## Install from package
28-
29-
Get the PKG (binary) from the big "Download" button on the
30-
[home page](https://dvc.org).
31-
32-
> Note that currently, in order to open the PKG file, you must go to the
33-
> **Downloads** directory in Finder and do a
34-
> [secondary click](https://support.apple.com/guide/mac-help/right-click-mh35853/mac)
35-
> on it, then select "Open With" > **Installer.app**, and click the **Open**
36-
> button.
37-
38-
> You may try
39-
> [these instructions](https://stackoverflow.com/questions/25925752/uninstall-packages-in-mac-os-x/42120328#42120328)
40-
> to uninstall the macOS package.
41-
4227
## Install with pip
4328

4429
<admon type="tip">
@@ -108,3 +93,17 @@ $ mamba install -c conda-forge dvc-s3
10893
In this case it installs the `boto3` library along with DVC.
10994

11095
</details>
96+
97+
## Install from package
98+
99+
[Download the macOS PKG installer directly](https://dvc.org/download/osx/dvc-3.64.1).
100+
101+
> Note that currently, in order to open the PKG file, you must go to the
102+
> **Downloads** directory in Finder and do a
103+
> [secondary click](https://support.apple.com/guide/mac-help/right-click-mh35853/mac)
104+
> on it, then select "Open With" > **Installer.app**, and click the **Open**
105+
> button.
106+
107+
> You may try
108+
> [these instructions](https://stackoverflow.com/questions/25925752/uninstall-packages-in-mac-os-x/42120328#42120328)
109+
> to uninstall the macOS package.

content/docs/install/windows.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -117,8 +117,8 @@ In this case it installs the `boto3` library along with DVC.
117117

118118
## Windows installer
119119

120-
A quick way is to use the self-contained, executable installer (binary), which
121-
is available from the big "Download" button on the [home page](https://dvc.org).
120+
A quick option on Windows is to install DVC using the self-contained executable
121+
installer. [Download the latest version here][windows-installer-download-link].
122122

123123
You'll need to download and run the installer again each time you want to update
124124
DVC. You may use Windows Uninstaller to
@@ -128,3 +128,5 @@ DVC. You may use Windows Uninstaller to
128128
> they can use them to
129129
> [optimize DVC](/user-guide/data-management/large-dataset-optimization)
130130
> operations.
131+
132+
[windows-installer-download-link]: https://dvc.org/download/win/dvc-3.64.1

content/docs/start/index.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,30 @@ a 100Gb file in less than a second with a `git checkout`.
2727

2828
_💫 DVC is your *"Git for data"*!_
2929

30+
## Installing DVC
31+
32+
First things first, let's install DVC. The easiest way to install dvc is with
33+
[`uv`](https://docs.astral.sh/uv/) or [`pipx`](https://pipx.pypa.io/stable/):
34+
35+
```cli
36+
$ uv tool install dvc # or,
37+
$ pipx install dvc
38+
```
39+
40+
Once it's installed, verify dvc is available by running:
41+
42+
```cli
43+
$ dvc --help
44+
```
45+
46+
If you see a help message listing dvc commands, you are good to continue!
47+
48+
<admon type="tip">
49+
50+
See the [Installation Guide](/install) for more installation options.
51+
52+
</admon>
53+
3054
## Initializing a project
3155

3256
Before we begin, settle on a directory for this guide. Everything we will do

0 commit comments

Comments
 (0)