disk → help
Ctrl previousnext Ctrl

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;
  • no need to be constantly connected to work with 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.

Installing the client

To install the client automatically, use the command for quickly installing a package.

Example of quick installation of a .deb package

echo "deb stable main" | sudo tee -a /etc/apt/sources.list.d/yandex.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 necessary version of the package at the corresponding link below.

Package format32-bit64-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 installing using the dpkg package manager

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

Note. The repository is automatically installed at the address /etc/apt/sources.list.d/yandex.list

Example of installing 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.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 important 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 for storing a local copy of Disk. If you leave the name blank, a Yandex.Disk folder will be created in the home directory.
  2. Specify whether or not to use a proxy server (y/n).
  3. Specify whether or not to run the client at start up (y/n).
  4. Enter your Yandex user name.
  5. Enter your Yandex password.

After the master completes its work, the configuration file config.cfg will be created in the directory ~/.config/yandex-disk.

Using the client


Use the following commands to work with the client:

  • token — to receive your log-in key (OAuth token) for your Yandex user name (USERNAME). When entering the command, you can indicate your Yandex password (PASSWORD) and specify the file name to store the token 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

Indicate the directory to store a local copy of Disk. If the name was not specified when running setup, the catalog ~/Yandex.Disk will be used by default.

--auth=FILE, -a FILE

Indicate the file with 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 option --overwrite is additionally specified, local files will be overwritten.


Allow changes made in 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 data

# Catalog for storing local copy of Disk.

# Do not sync specified catalogs.

# Specify proxy server. Examples:


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 forbid syncing separate folders by specifying them when entering a command (the option --exclude-dirs=DIR1,DIR2,...) or by adding them to the exclusion list exclude-dirs in the file config.cfg.

Does the console client support the use of symbolic links?

Yes, it does.

Can the console client be used for data replication?

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