<!doctypehtml><html lang=en><meta charset=utf-8><meta content=IE=edge,chrome=1 http-equiv=X-UA-Compatible><meta content=width=device-width,initial-scale=1,shrink-to-fit=no name=viewport><meta content="Mail.ru Cloud"name=description><meta content="Nick Craig-Wood"name=author><link rel="shortcut icon"href=/img/rclone-32x32.png type=image/png><script async src=https://www.googletagmanager.com/gtag/js?id=UA-51081799-1></script><script>window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', 'UA-51081799-1');</script><title>
   Mailru
  </title><link href=https://rclone.org/mailru/ rel=canonical><link href=/css/bootstrap.min.4.4.1.css rel=stylesheet><link href=/css/font-awesome.min.5.10.2.css rel=stylesheet><link href=/css/custom.css?r=-62135596800 rel=stylesheet><body><nav class="navbar navbar-expand-md navbar-dark bg-dark"><a class=navbar-brand href=/> <img alt="rclone logo"class=rclone-logo src=/img/logo_on_dark__horizontal_color.svg> </a><button aria-label="Toggle navigation"aria-controls=navbarSupportedContent aria-expanded=false class=navbar-toggler data-target=#navbarSupportedContent data-toggle=collapse type=button><span class=navbar-toggler-icon> </span></button><div class="collapse navbar-collapse"id=navbarSupportedContent><ul class="navbar-nav mr-auto"><li class="nav-item active"><a class=nav-link href=/downloads/> Downloads </a><li class="nav-item active dropdown"><a class="nav-link dropdown-toggle"aria-expanded=false aria-haspopup=true data-toggle=dropdown href=# id=navbarDropdown role=button> Docs </a> <div aria-labelledby=navbarDropdown class=dropdown-menu><a class=dropdown-item href=/install/> <i class="fa fa-book"> </i> Installation </a><a class=dropdown-item href=/docs/> <i class="fa fa-book"> </i> Usage </a><a class=dropdown-item href=/filtering/> <i class="fa fa-book"> </i> Filtering </a><a class=dropdown-item href=/gui/> <i class="fa fa-book"> </i> GUI </a><a class=dropdown-item href=/rc/> <i class="fa fa-book"> </i> Remote Control </a><a class=dropdown-item href=/changelog/> <i class="fa fa-book"> </i> Changelog </a><a class=dropdown-item href=/bugs/> <i class="fa fa-book"> </i> Bugs </a><a class=dropdown-item href=/faq/> <i class="fa fa-book"> </i> FAQ </a><a class=dropdown-item href=/flags/> <i class="fa fa-book"> </i> Flags </a><a class=dropdown-item href=/licence/> <i class="fa fa-book"> </i> Licence </a><a class=dropdown-item href=/authors/> <i class="fa fa-book"> </i> Authors </a><a class=dropdown-item href=/privacy/> <i class="fa fa-book"> </i> Privacy Policy </a></div><li class="nav-item active dropdown"><a class="nav-link dropdown-toggle"aria-expanded=false aria-haspopup=true data-toggle=dropdown href=# id=navbarDropdown role=button> Commands </a> <div class="dropdown-menu pre-scrollable"aria-labelledby=navbarDropdown><a class=dropdown-item href=/commands/> <i class="fas fa-map"> </i> Overview </a><div class=dropdown-divider></div><a class=dropdown-item href=/commands/rclone_config/> <i class="fa fa-book"> </i> rclone config </a><a class=dropdown-item href=/commands/rclone_copy/> <i class="fa fa-book"> </i> rclone copy </a><a class=dropdown-item href=/commands/rclone_sync/> <i class="fa fa-book"> </i> rclone sync </a><a class=dropdown-item href=/commands/rclone_move/> <i class="fa fa-book"> </i> rclone move </a><a class=dropdown-item href=/commands/rclone_purge/> <i class="fa fa-book"> </i> rclone purge </a><a class=dropdown-item href=/commands/rclone_mkdir/> <i class="fa fa-book"> </i> rclone mkdir </a><a class=dropdown-item href=/commands/rclone_rmdir/> <i class="fa fa-book"> </i> rclone rmdir </a><a class=dropdown-item href=/commands/rclone_check/> <i class="fa fa-book"> </i> rclone check </a><a class=dropdown-item href=/commands/rclone_ls/> <i class="fa fa-book"> </i> rclone ls </a><a class=dropdown-item href=/commands/rclone_lsd/> <i class="fa fa-book"> </i> rclone lsd </a><a class=dropdown-item href=/commands/rclone_delete/> <i class="fa fa-book"> </i> rclone delete </a><a class=dropdown-item href=/commands/rclone_size/> <i class="fa fa-book"> </i> rclone size </a><a class=dropdown-item href=/commands/rclone_mount/> <i class="fa fa-book"> </i> rclone mount </a><a class=dropdown-item href=/commands/rclone_ncdu/> <i class="fa fa-book"> </i> rclone ncdu </a><a class=dropdown-item href=/commands/rclone_cat/> <i class="fa fa-book"> </i> rclone cat </a><a class=dropdown-item href=/commands/rclone_rcat/> <i class="fa fa-book"> </i> rclone rcat </a><a class=dropdown-item href=/commands/rclone_serve/> <i class="fa fa-book"> </i> rclone serve </a></div><li class="nav-item active dropdown"><a class="nav-link dropdown-toggle"aria-expanded=false aria-haspopup=true data-toggle=dropdown href=# id=navbarDropdown role=button> Storage Systems </a> <div class="dropdown-menu pre-scrollable"aria-labelledby=navbarDropdown><a class=dropdown-item href=/overview/> <i class="fas fa-map"> </i> Overview </a><div class=dropdown-divider></div><a class=dropdown-item href=/fichier/> <i class="fa fa-archive"> </i> 1Fichier </a><a class=dropdown-item href=/alias/> <i class="fa fa-link"> </i> Alias </a><a class=dropdown-item href=/amazonclouddrive/> <i class="fab fa-amazon"> </i> Amazon Drive </a><a class=dropdown-item href=/s3/> <i class="fab fa-amazon"> </i> Amazon S3 </a><a class=dropdown-item href=/b2/> <i class="fa fa-fire"> </i> Backblaze B2 </a><a class=dropdown-item href=/box/> <i class="fa fa-archive"> </i> Box </a><a class=dropdown-item href=/cache/> <i class="fa fa-archive"> </i> Cache </a><a class=dropdown-item href=/chunker/> <i class="fa fa-cut"> </i> Chunker (splits large files) </a><a class=dropdown-item href=/compress/> <i class="fas fa-compress"> </i> Compress (transparent gzip compression) </a><a class=dropdown-item href=/sharefile/> <i class="fas fa-share-square"> </i> Citrix ShareFile </a><a class=dropdown-item href=/crypt/> <i class="fa fa-lock"> </i> Crypt (encrypts the others) </a><a class=dropdown-item href=/dropbox/> <i class="fab fa-dropbox"> </i> Dropbox </a><a class=dropdown-item href=/filefabric/> <i class="fa fa-cloud"> </i> Enterprise File Fabric </a><a class=dropdown-item href=/ftp/> <i class="fa fa-file"> </i> FTP </a><a class=dropdown-item href=/googlecloudstorage/> <i class="fab fa-google"> </i> Google Cloud Storage </a><a class=dropdown-item href=/drive/> <i class="fab fa-google"> </i> Google Drive </a><a class=dropdown-item href=/googlephotos/> <i class="fas fa-images"> </i> Google Photos </a><a class=dropdown-item href=/hdfs/> <i class="fa fa-globe"> </i> HDFS (Hadoop Distributed Filesystem) </a><a class=dropdown-item href=/http/> <i class="fa fa-globe"> </i> HTTP </a><a class=dropdown-item href=/hubic/> <i class="fa fa-space-shuttle"> </i> Hubic </a><a class=dropdown-item href=/jottacloud/> <i class="fa fa-cloud"> </i> Jottacloud </a><a class=dropdown-item href=/koofr/> <i class="fa fa-suitcase"> </i> Koofr </a><a class=dropdown-item href=/mailru/> <i class="fa fa-at"> </i> Mail.ru Cloud </a><a class=dropdown-item href=/mega/> <i class="fa fa-archive"> </i> Mega </a><a class=dropdown-item href=/memory/> <i class="fas fa-memory"> </i> Memory </a><a class=dropdown-item href=/azureblob/> <i class="fab fa-windows"> </i> Microsoft Azure Blob Storage </a><a class=dropdown-item href=/onedrive/> <i class="fab fa-windows"> </i> Microsoft OneDrive </a><a class=dropdown-item href=/opendrive/> <i class="fa fa-space-shuttle"> </i> OpenDrive </a><a class=dropdown-item href=/qingstor/> <i class="fas fa-hdd"> </i> QingStor </a><a class=dropdown-item href=/swift/> <i class="fa fa-space-shuttle"> </i> Openstack Swift </a><a class=dropdown-item href=/pcloud/> <i class="fa fa-cloud"> </i> pCloud </a><a class=dropdown-item href=/premiumizeme/> <i class="fa fa-user"> </i> premiumize.me </a><a class=dropdown-item href=/putio/> <i class="fas fa-parking"> </i> put.io </a><a class=dropdown-item href=/seafile/> <i class="fa fa-server"> </i> Seafile </a><a class=dropdown-item href=/sftp/> <i class="fa fa-server"> </i> SFTP </a><a class=dropdown-item href=/sugarsync/> <i class="fas fa-dove"> </i> SugarSync </a><a class=dropdown-item href=/tardigrade/> <i class="fas fa-dove"> </i> Tardigrade </a><a class=dropdown-item href=/union/> <i class="fa fa-link"> </i> Union (merge backends) </a><a class=dropdown-item href=/webdav/> <i class="fa fa-server"> </i> WebDAV </a><a class=dropdown-item href=/yandex/> <i class="fa fa-space-shuttle"> </i> Yandex Disk </a><a class=dropdown-item href=/zoho/> <i class="fas fa-folder"> </i> Zoho WorkDrive </a><div class=dropdown-divider></div><a class=dropdown-item href=/local/> <i class="fas fa-hdd"> </i> The local filesystem </a></div><li class="nav-item active"><a class=nav-link href=/contact/> <i class="fa fa-envelope"> </i> Contact </a><li class="nav-item active"><a class=nav-link href=/donate/> <i class="fa fa-heart heart"> </i> Donate </a></ul></div></nav><div class=container><div class=row><div class=col-md-10><h2 id=hahahugoshortcode-s0-hbhb-mail-ru-cloud><i class="fas fa-at"aria-hidden=true> </i> Mail.ru Cloud</h2><p><a href=https://cloud.mail.ru/> Mail.ru Cloud </a> is a cloud storage provided by a Russian internet company <a href=https://mail.ru> Mail.Ru Group </a> . The official desktop client is <a href=https://disk-o.cloud/en> Disk-O: </a> , available on Windows and Mac OS.<p>Currently it is recommended to disable 2FA on Mail.ru accounts intended for rclone until it gets eventually implemented.<h3 id=features-highlights>Features highlights</h3><ul><li>Paths may be as deep as required, e.g. <code>
        remote:directory/subdirectory
       </code><li>Files have a <code>
        last modified time
       </code> property, directories don't<li>Deleted files are by default moved to the trash<li>Files and directories can be shared via public links<li>Partial uploads or streaming are not supported, file size must be known before upload<li>Maximum file size is limited to 2G for a free account, unlimited for paid accounts<li>Storage keeps hash for all files and performs transparent deduplication, the hash algorithm is a modified SHA1<li>If a particular file is already present in storage, one can quickly submit file hash instead of long file upload (this optimization is supported by rclone)</ul><h3 id=configuration>Configuration</h3><p>Here is an example of making a mailru configuration. First create a Mail.ru Cloud account and choose a tariff, then run<pre><code>rclone config
</code></pre><p>This will guide you through an interactive setup process:<pre><code>No remotes found - make a new one
n) New remote
s) Set configuration password
q) Quit config
n/s/q> n
name> remote
Type of storage to configure.
Type of storage to configure.
Enter a string value. Press Enter for the default ("").
Choose a number from below, or type in your own value
[snip]
XX / Mail.ru Cloud
   \ "mailru"
[snip]
Storage> mailru
User name (usually email)
Enter a string value. Press Enter for the default ("").
user> username@mail.ru
Password
y) Yes type in my own password
g) Generate random password
y/g> y
Enter the password:
password:
Confirm the password:
password:
Skip full upload if there is another file with same data hash.
This feature is called "speedup" or "put by hash". It is especially efficient
in case of generally available files like popular books, video or audio clips
[snip]
Enter a boolean value (true or false). Press Enter for the default ("true").
Choose a number from below, or type in your own value
 1 / Enable
   \ "true"
 2 / Disable
   \ "false"
speedup_enable> 1
Edit advanced config? (y/n)
y) Yes
n) No
y/n> n
Remote config
--------------------
[remote]
type = mailru
user = username@mail.ru
pass = *** ENCRYPTED ***
speedup_enable = true
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
</code></pre><p>Configuration of this backend does not require a local web browser. You can use the configured backend as shown below:<p>See top level directories<pre><code>rclone lsd remote:
</code></pre><p>Make a new directory<pre><code>rclone mkdir remote:directory
</code></pre><p>List the contents of a directory<pre><code>rclone ls remote:directory
</code></pre><p>Sync <code>
       /home/local/directory
      </code> to the remote path, deleting any excess files in the path.<pre><code>rclone sync -i /home/local/directory remote:directory
</code></pre><h3 id=modified-time>Modified time</h3><p>Files support a modification time attribute with up to 1 second precision. Directories do not have a modification time, which is shown as "Jan 1 1970".<h3 id=hash-checksums>Hash checksums</h3><p>Hash sums use a custom Mail.ru algorithm based on SHA1. If file size is less than or equal to the SHA1 block size (20 bytes), its hash is simply its data right-padded with zero bytes. Hash sum of a larger file is computed as a SHA1 sum of the file data bytes concatenated with a decimal representation of the data length.<h3 id=emptying-trash>Emptying Trash</h3><p>Removing a file or directory actually moves it to the trash, which is not visible to rclone but can be seen in a web browser. The trashed file still occupies part of total quota. If you wish to empty your trash and free some quota, you can use the <code>
       rclone cleanup remote:
      </code> command, which will permanently delete all your trashed files. This command does not take any path arguments.<h3 id=quota-information>Quota information</h3><p>To view your current quota you can use the <code>
       rclone about remote:
      </code> command which will display your usage limit (quota) and the current usage.<h4 id=restricted-filename-characters>Restricted filename characters</h4><p>In addition to the <a href=/overview/#restricted-characters> default restricted characters set </a> the following characters are also replaced:<table><thead><tr><th>Character<th align=center>Value<th align=center>Replacement<tbody><tr><td>"<td align=center>0x22<td align=center>＂<tr><td>*<td align=center>0x2A<td align=center>＊<tr><td>:<td align=center>0x3A<td align=center>：<tr><td><<td align=center>0x3C<td align=center>＜<tr><td>><td align=center>0x3E<td align=center>＞<tr><td>?<td align=center>0x3F<td align=center>？<tr><td>\<td align=center>0x5C<td align=center>＼<tr><td>|<td align=center>0x7C<td align=center>｜</table><p>Invalid UTF-8 bytes will also be <a href=/overview/#invalid-utf8> replaced </a> , as they can't be used in JSON strings.<h3 id=limitations>Limitations</h3><p>File size limits depend on your account. A single file size is limited by 2G for a free account and unlimited for paid tariffs. Please refer to the Mail.ru site for the total uploaded size limits.<p>Note that Mailru is case insensitive so you can't have a file called "Hello.doc" and one called "hello.doc".<h3 id=standard-options>Standard Options</h3><p>Here are the standard options specific to mailru (Mail.ru Cloud).<h4 id=mailru-user>--mailru-user</h4><p>User name (usually email)<ul><li>Config: user<li>Env Var: RCLONE_MAILRU_USER<li>Type: string<li>Default: ""</ul><h4 id=mailru-pass>--mailru-pass</h4><p>Password<p><strong> NB </strong> Input to this must be obscured - see <a href=/commands/rclone_obscure/> rclone obscure </a> .<ul><li>Config: pass<li>Env Var: RCLONE_MAILRU_PASS<li>Type: string<li>Default: ""</ul><h4 id=mailru-speedup-enable>--mailru-speedup-enable</h4><p>Skip full upload if there is another file with same data hash. This feature is called "speedup" or "put by hash". It is especially efficient in case of generally available files like popular books, video or audio clips, because files are searched by hash in all accounts of all mailru users. It is meaningless and ineffective if source file is unique or encrypted. Please note that rclone may need local memory and disk space to calculate content hash in advance and decide whether full upload is required. Also, if rclone does not know file size in advance (e.g. in case of streaming or partial uploads), it will not even try this optimization.<ul><li>Config: speedup_enable<li>Env Var: RCLONE_MAILRU_SPEEDUP_ENABLE<li>Type: bool<li>Default: true<li>Examples: <ul><li>"true" <ul><li>Enable</ul><li>"false" <ul><li>Disable</ul></ul></ul><h3 id=advanced-options>Advanced Options</h3><p>Here are the advanced options specific to mailru (Mail.ru Cloud).<h4 id=mailru-speedup-file-patterns>--mailru-speedup-file-patterns</h4><p>Comma separated list of file name patterns eligible for speedup (put by hash). Patterns are case insensitive and can contain '*' or '?' meta characters.<ul><li>Config: speedup_file_patterns<li>Env Var: RCLONE_MAILRU_SPEEDUP_FILE_PATTERNS<li>Type: string<li>Default: " <em> .mkv, </em> .avi, <em> .mp4, </em> .mp3, <em> .zip, </em> .gz, <em> .rar, </em> .pdf"<li>Examples: <ul><li>"" <ul><li>Empty list completely disables speedup (put by hash).</ul><li>"*" <ul><li>All files will be attempted for speedup.</ul><li>" <em> .mkv, </em> .avi, <em> .mp4, </em> .mp3" <ul><li>Only common audio/video files will be tried for put by hash.</ul><li>" <em> .zip, </em> .gz, <em> .rar, </em> .pdf" <ul><li>Only common archives or PDF books will be tried for speedup.</ul></ul></ul><h4 id=mailru-speedup-max-disk>--mailru-speedup-max-disk</h4><p>This option allows you to disable speedup (put by hash) for large files (because preliminary hashing can exhaust you RAM or disk space)<ul><li>Config: speedup_max_disk<li>Env Var: RCLONE_MAILRU_SPEEDUP_MAX_DISK<li>Type: SizeSuffix<li>Default: 3G<li>Examples: <ul><li>"0" <ul><li>Completely disable speedup (put by hash).</ul><li>"1G" <ul><li>Files larger than 1Gb will be uploaded directly.</ul><li>"3G" <ul><li>Choose this option if you have less than 3Gb free on local disk.</ul></ul></ul><h4 id=mailru-speedup-max-memory>--mailru-speedup-max-memory</h4><p>Files larger than the size given below will always be hashed on disk.<ul><li>Config: speedup_max_memory<li>Env Var: RCLONE_MAILRU_SPEEDUP_MAX_MEMORY<li>Type: SizeSuffix<li>Default: 32M<li>Examples: <ul><li>"0" <ul><li>Preliminary hashing will always be done in a temporary disk location.</ul><li>"32M" <ul><li>Do not dedicate more than 32Mb RAM for preliminary hashing.</ul><li>"256M" <ul><li>You have at most 256Mb RAM free for hash calculations.</ul></ul></ul><h4 id=mailru-check-hash>--mailru-check-hash</h4><p>What should copy do if file checksum is mismatched or invalid<ul><li>Config: check_hash<li>Env Var: RCLONE_MAILRU_CHECK_HASH<li>Type: bool<li>Default: true<li>Examples: <ul><li>"true" <ul><li>Fail with error.</ul><li>"false" <ul><li>Ignore and continue.</ul></ul></ul><h4 id=mailru-user-agent>--mailru-user-agent</h4><p>HTTP user agent used internally by client. Defaults to "rclone/VERSION" or "--user-agent" provided on command line.<ul><li>Config: user_agent<li>Env Var: RCLONE_MAILRU_USER_AGENT<li>Type: string<li>Default: ""</ul><h4 id=mailru-quirks>--mailru-quirks</h4><p>Comma separated list of internal maintenance flags. This option must not be used by an ordinary user. It is intended only to facilitate remote troubleshooting of backend issues. Strict meaning of flags is not documented and not guaranteed to persist between releases. Quirks will be removed when the backend grows stable. Supported quirks: atomicmkdir binlist unknowndirs<ul><li>Config: quirks<li>Env Var: RCLONE_MAILRU_QUIRKS<li>Type: string<li>Default: ""</ul><h4 id=mailru-encoding>--mailru-encoding</h4><p>This sets the encoding for the backend.<p>See: the <a href=/overview/#encoding> encoding section in the overview </a> for more info.<ul><li>Config: encoding<li>Env Var: RCLONE_MAILRU_ENCODING<li>Type: MultiEncoder<li>Default: Slash,LtGt,DoubleQuote,Colon,Question,Asterisk,Pipe,BackSlash,Del,Ctl,InvalidUtf8,Dot</ul></div><div class=col-md-2><div class=card><div style="padding: 5px 10px;"class=card-header>Share and Enjoy</div><div class=card-body><p class=menu><i class="fab fa-twitter"aria-hidden=true> </i> <a aria-label="Share on Twitter"href=https://twitter.com/intent/tweet/?text=rclone%20-%20rsync%20for%20cloud%20storage%20from%20%40njcw&url=https%3A%2F%2Frclone.org rel=noopener target=_blank> Twitter </a> <br> <i class="fab fa-facebook"aria-hidden=true> </i> <a aria-label="Share on Facebook"href=https://facebook.com/sharer/sharer.php?u=https%3A%2F%2Frclone.org rel=noopener target=_blank> Facebook </a> <br> <i class="fab fa-reddit"aria-hidden=true> </i> <a aria-label="Share on Reddit"href=https://reddit.com/submit/?url=https%3A%2F%2Frclone.org&resubmit=true&title=rclone%20-%20rsync%20for%20cloud%20storage rel=noopener target=_blank> Reddit </a> <br> <iframe allowtransparency frameborder=0 height=20 scrolling=no src=//ghbtns.com/github-btn.html?user=rclone&repo=rclone&type=star&count=true width=120></iframe></div></div><div class=card><div style="padding: 5px 15px;"class=card-header>Links</div><div class=card-body><p class=menu><i class="fa fa-comments"aria-hidden=true> </i> <a href=https://forum.rclone.org> Rclone forum </a> <br> <i class="fab fa-github"aria-hidden=true> </i> <a href=https://github.com/rclone/rclone> GitHub project </a> <br> <i class="fab fa-slack"aria-hidden=true> </i> <a href=https://slack-invite.rclone.org/> Rclone slack </a> <br> <i class="fa fa-book"aria-hidden=true> </i> <a href=https://github.com/rclone/rclone/wiki> Rclone Wiki </a> <br> <i class="fa fa-heart heart"aria-hidden=true> </i> <a href=/donate/> Donate </a> <br> <i class="fab fa-twitter"aria-hidden=true> </i> <a href=https://twitter.com/njcw> @njcw </a></div></div></div></div><footer><div class=row><div class=col-md-10><div class="card card-body"><p style="font-size: 90%;">© <a href=https://www.craig-wood.com/nick/> Nick Craig-Wood </a> 2014-2021 <br> Source file <a href=https://github.com/rclone/rclone/blob/master/docs/content/mailru.md> mailru.md </a> last updated <a href=https://github.com/rclone/rclone/commit/bf8542c67004428ad25b8eab1fa7e34608ccb908> 2021-02-09 </a> <br> Website hosted on a <a href=https://www.memset.com/dedicated-servers/vps/> <span style="font-weight: bold; font-family: arial black, arial, sans-serif; font-style: italic;"> MEMSET CLOUD VPS </span> </a> , uploaded with <a href=https://rclone.org> rclone </a> and built with <a href=https://github.com/spf13/hugo> Hugo </a> . Logo by <a href=https://twitter.com/andy23> @andy23 </a> .</div></div></div></footer></div><script src=/js/jquery.min.3.5.1.js></script><script src=/js/popper.min.1.16.0.js></script><script src=/js/bootstrap.min.4.4.1.js></script><script src=/js/custom.js?r=-62135596800></script>