Console client for Linux

The Yandex.Disk console client for Linux lets you manage files on Disk without using a window interface or programs that support WebDAV.

The advantages of the console client compared to a WebDAV connection:

  • low system resource requirements
  • faster file reading and writing speeds
  • faster syncing with the Disk server
  • you don't need to be connected to the web in order to manage files

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

  • Ubuntu Linux 8.04 and higher
  • Debian 5 and higher
  • Fedora 9 and higher
  • Red Hat Enterprise Linux 6 and higher
  • CentOS 6 and higher
  1. Install the client
  2. Setup Wizard
  3. Use the client
  4. FAQ
  5. GUI for Linux console client

Install the client

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

Example of quick installation of a .deb package
echo "deb stable main" | sudo tee -a /etc/apt/sources.list.d/yandex-disk.list > /dev/null && wget -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 yandex-disk_latest_amd64
.rpm (Fedora, Red Hat Enterprise Linux, CentOS) yandex-disk-latest.i386 yandex-disk-latest.x86_64
Attention. By downloading the program, you agree to the terms of the License Agreement.
Example of installation using the dpkg package manager
# dpkg -i yandex-disk_0.1.0.103_i386.deb
Note. The repository is automatically installed at /etc/apt/sources.list.d/yandex.list
Example of installation using the rpm package manager
# rpm -ivh yandex-disk-
Note. 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
Attention. Save a copy of the file /etc/apt/sources.list.d/yandex.list before making changes to it.
# echo "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
# yum install yandex-disk

File contents yandex.repo:


You may need to import an open GPG key into the system to check the package's digital signature.

Import a GPG key for a .deb package
sudo apt-key add YANDEX-DISK-KEY.GPG
Import a GPG key for a .rpm package
sudo rpm --import

Setup Wizard

You can run the 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.
  2. Indicate whether or not to use a proxy server (y/n).
  3. Indicate whether or not to launch the client at start up (y/n).
  4. Enter your Yandex username.
  5. Enter your Yandex password.
    Attention. If you use two-factor authentication, you will need a one-time password, which is generated by the “Yandex.Key” app, to log in to Yandex.Disk.

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

Use the client


Use the following commands to work with the client:

  • Token: to get your log-in key (OAuth token) for your Yandex username (USERNAME). When entering the command, you can enter your Yandex password (PASSWORD) as well as the token file and its directory (FILE). If no additional options are specified, the file passwd will be created in the directory ~/.config/yandex-disk to store the token.
    $ yandex-disk token [-p, --password=PASSWORD] [OPTION] USERNAME [FILE]
  • Start: launch daemon and sync all folders except those on the exclusion list exclude-dirs.
    $ yandex-disk start [OPTION]
  • Status: display the daemon's status (sync status, sync errors, list of synced files, and total and available space on Disk).
    $ yandex-disk status [OPTION]
  • Stop: stop the daemon.
    $ yandex-disk stop [OPTION]
  • Sync: sync all folders except those on the exclusion list exclude-dirs.
    $ yandex-disk sync [OPTION]
  • Publish: get a public link to the specified file or folder (FILE).
    $ yandex-disk publish [OPTION] FILE
  • Unpublish: unpublish the specified file or folder (FILE).
    $ yandex-disk unpublish FILE

Additional options [OPTION]

--config=FILE, -c FILE

Show configuration file. The file config.cfg is used by default in the directory ~/.config/yandex-disk.

--dir=DIR, -d DIR

Enter the directory where a local copy of Disk will be stored. If the name was not entered when running setup, the catalog ~/Yandex.Disk will be used by default.

--auth=FILE, -a FILE

Enter the file containing log-in data. The default file is passwd, which was created using the command token or the setup wizard and is stored in the directory ~/.config/yandex-disk.


Do not sync the specified directories. In order for these settings to always apply, these directories must be added to the exclusion list exclude-dirs in the file config.cfg. For settings to work correctly, the names of excluded directories should be separated with commas, not spaces.


Forbid changing files on the Disk server and run sync only in a local copy. In case of conflicts when syncing, local files will be renamed. If the --overwrite setting is also enabled, local files will be overwritten.


Allow changes made to the local copy of Disk to be overwritten when syncing with the server. Use together with the --read-only option.

--no-daemon, -D

Launch daemon without returning management to the console. The daemon must be stopped by launching the command yandex-disk stop in another console or by closing the current console to return management.

--help, -h

Display help.


Set proxy server. Valid parameters:

  • Auto: use system proxy settings (used by default)
  • No: do not use proxy server
  • Protocol,address,port,login,password: set manually

Examples of using commands

$ yandex-disk start -c ~/ydconfig/newconfig.cfg # launch daemon and sync with specified configuration file $ yandex-disk start --exclude-dirs=Foto # do not sync folder 'Foto'$ yandex-disk sync --read-only # sync folders in 'read-only' mode$ yandex-disk publish Foto # get a public link to the folder 'Foto'

Example of the 'config.cfg' file

# Path to file with log-in dataauth="/home/user/ydconfig/my_passwd"# Catalog for storing local copy of Disk.dir="/home/user/myDisk"# Do not sync specified catalogs.#exclude-dirs="exclude/dir1,exclude/dir2,path/to/another/exclude/dir"# Specify proxy server. Examples:#proxy=https,,80#proxy=https,,80,login,password#proxy=https,,443#proxy=socks4,my.proxy.local,1080,login,password#proxy=socks5,my.another.proxy.local,1081#proxy=auto#proxy=no


What Disk features are available in the console client?

All of the main Disk features are available when using the console client: syncing and sharing files and folders, and custom folder syncing.

Does custom folder syncing work in the console client?

Yes. You can choose to not sync certain folders when entering the command (setting --exclude-dirs=DIR1,DIR2,...) or by adding them to the exclusion list exclude-dirs in the file config.cfg.

Can the console client be used for data replication?

Yes. Data can be replicated using the --read-only parameter.

GUI for Linux console client

You can work with the console client using a GUI from third-party developers.

Name Description
YD-tools This utility supports all of the basic functions of the console client. An icon in the taskbar shows the current synchronization status and can use pop-up notifications to keep you informed of any changes. The utility also adds item posting to the context menu.
Ya-gui This utility lets you launch daemons in normal or advanced mode (with additional options). It adds items to the context menu that are responsible for publishing. In running state it lets you enable and disable access to files, halt a daemon, and display information about the daemon's current status.
Yandex.Disk ServiceMenu Lets you quickly access Yandex.Disk: copy public links to files or folders in clipboard, save files to your Yandex.Disk folder.
The Magic Folder Widget Gives you access to links to share.

If you know of other GUIs for console clients that are not included on this page, please let us know.

You can also work with Yandex.Disk through WebDAV.