---
metadata:
  - name: generator
    content: Diplodoc Platform v5.42.1
alternate:
  - https://yandex.com/support/yandex-360/customers/disk/desktop/linux/en/installation.md
keywords:
  - o
  - t
  - h
  - e
  - r
  - s
  - ' '
  - w
  - 'n'
  - ''''
  - m
  - 'y'
  - f
  - i
  - l
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/support/yandex-360/customers/disk/desktop/linux/en/llms.txt

# Installation and setup



## Installation {#install}



The console client can be installed on the following operating systems:

* Ubuntu Linux 8.04 and higher.
* Debian 5 and higher
* Fedora 9 and later
* Red Hat Enterprise Linux 6 and higher
* CentOS 6 and higher  

To install the client automatically, use the command for quick package installation.

**Example of quick installation of a _.deb_ package**

 
:   ```
    echo "deb http://repo.yandex.ru/yandex-disk/deb/ stable main" | sudo tee -a /etc/apt/sources.list.d/yandex-disk.list > /dev/null && wget http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG -O- | sudo apt-key add - && sudo apt-get update && sudo apt-get install -y yandex-disk
    ```

To install the client manually, download the appropriate version of the package at the corresponding link below.


#|
||
**Package format**
|
**32-bit**
|
**64-bit**
||
||
.deb (Ubuntu, Debian)
|
[yandex-disk_latest_i386](http://repo.yandex.ru/yandex-disk/yandex-disk_latest_i386.deb)
|
[yandex-disk_latest_amd64](http://repo.yandex.ru/yandex-disk/yandex-disk_latest_amd64.deb)
||
||
.rpm (Fedora, Red Hat Enterprise Linux, CentOS)
|
[yandex-disk-latest.i386](http://repo.yandex.ru/yandex-disk/yandex-disk-latest.i386.rpm)
|
[yandex-disk-latest.x86_64](http://repo.yandex.ru/yandex-disk/yandex-disk-latest.x86_64.rpm)
||
|#


{% note alert %}

By downloading the program, you agree to the terms of the [License Agreement](https://yandex.com/legal/desktop_software_agreement/).

{% endnote %}


**Example of installation using the dpkg package manager**

 
:   ```
    # dpkg -i yandex-disk_0.1.0.103_i386.deb
    ```

The repository is automatically installed at `/etc/apt/sources.list.d/yandex.list`.

**Example of installing using the rpm package manager**

 
:   ```
    # rpm -ivh yandex-disk-0.1.0.103-1.fedora.i386.rpm
    ```

The repository is automatically installed at the address` /etc/yum.repos.d/yandex.repo`.

You can also add the repository with the `yandex-disk` package to the list of available package manager repositories and install the package using the utilities `apt-get` or `yum`.

**Installation using apt-get**

 
:   {% note alert %}
    
    Save a copy of the file `/etc/apt/sources.list.d/yandex.list` before making changes to it.
    
    {% endnote %}
    
    
    ```
    # wget -O YANDEX-DISK-KEY.GPG http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
    # apt-key add YANDEX-DISK-KEY.GPG
    # echo "deb http://repo.yandex.ru/yandex-disk/deb/ stable main" >> /etc/apt/sources.list.d/yandex-disk.list
    # apt-get update
    # apt-get install yandex-disk
    ```

**Installation using yum**

 
:   ```
    # nano /etc/yum.repos.d/yandex.repo
    # rpm --import http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
    # yum install yandex-disk
    ```
    
    File contents `yandex.repo`:
    
    ```
    [yandex]
    name=Yandex
    failovermethod=priority
    baseurl=http://repo.yandex.ru/yandex-disk/rpm/stable/$basearch/
    enabled=1
    metadata_expire=1d
    gpgcheck=1
    gpgkey=http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
    ```



## Setup Wizard {#cli-setup}

You can run the initial client setup using the `setup` command.

```
$ yandex-disk setup
```

1. Enter the name of the directory where a local copy of Disk is stored. If you leave the name blank, a **Yandex Disk** folder will be created in the home directory.
1. Specify whether or not to use a proxy server (y/n).
1. Indicate whether or not to launch the client at startup (y/n).

After the Wizard has finished, the configuration file config.cfg will be created in the directory `~/.config/yandex-disk`.

#### {#config}

{% cut "Example of the 'config.cfg' file" %}

```
# Path to the authorization data file
auth="/home/user/.config/yandex-disk/passwd"

# Directory for storing a local copy of Yandex Disk.
dir="/home/user/myDisk"

# Do not sync the specified directories.
#exclude-dirs="exclude/dir1,exclude/dir2,path/to/another/exclude/dir"

# Specify the proxy server. Examples:
#proxy=https,127.0.0.1,80
#proxy=https,127.0.0.1,80,login,password
#proxy=https,127.0.0.1,443
#proxy=socks4,my.proxy.local,1080,login,password
#proxy=socks5,my.another.proxy.local,1081
#proxy=auto
#proxy=no
```

{% endcut %}


## Restore Yandex Disk {#recover-after-reinstall-os}

To restore Yandex Disk after reinstalling your operating system, replacing a hard drive, or deleting the program:

1. [Re-install the application](#install).
1. [Configure the client](#cli-setup). If you still have any old Yandex Disk files on your computer, they will automatically sync with the server.

<!-- source: en/_includes/support-button.md -->
<div class="cut-button">

{% cut "Contact support" %}

<div style="padding: 15px;
     margin: 10px 0;
     background: #FFFFFF;
     border-radius: 10px;
     border: 1px solid var(--g-color-line-generic);">
  <iframe style="background: #FFFFFF;"
        height="700"
        width="100%"
        frameborder="0"
        src="https://forms.yandex.ru/surveys/13644897.42fac11da1bae9914a4d4bc7e48facc9f032f9f2/?lang=en&locale=en&iframe=1">
  </iframe>
</div>

{% endcut %}

</div>


<!-- endsource: en/_includes/support-button.md -->

<!-- source: en/_includes/rm-3lvl-minitoc.md -->

<!-- endsource: en/_includes/rm-3lvl-minitoc.md -->