SearchImagesVideoNewsMapsMail
disk → help
Login
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
  • 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.

Installing the client

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.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 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-0.1.0.103-1.fedora.i386.rpm

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 http://repo.yandex.ru/yandex-disk/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 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

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

wget -O YANDEX-DISK-KEY.GPG http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG
sudo apt-key add YANDEX-DISK-KEY.GPG

Import a GPG key for a .rpm package

sudo rpm --import http://repo.yandex.ru/yandex-disk/YANDEX-DISK-KEY.GPG

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 user name.
  5. Enter your Yandex password.

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

Using the client

Commands

Use the following commands to work with the client:

  • token — to get your log-in key (OAuth token) for your Yandex user name (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.

--exclude-dirs=DIR1,DIR2,...

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.

--read-only

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.

--overwrite

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.

--proxy=PARAM

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
auth="/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,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

FAQ

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.

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.

GUI for Linux console client

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

NameDescription
YD-tools This utility supports almost all of the console client's main functions other than selective syncing. It adds items to the context menu that are responsible for publishing.
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.

Keyboard