2015-09-02 22:37:42 +00:00
---
2016-07-11 11:42:44 +00:00
title: "Amazon Drive"
description: "Rclone docs for Amazon Drive"
2022-11-17 17:56:24 +00:00
versionIntroduced: "v1.20"
2015-09-02 22:37:42 +00:00
---
2021-07-20 18:45:41 +00:00
# {{< icon "fab fa-amazon" >}} Amazon Drive
2015-09-02 22:37:42 +00:00
2018-07-09 15:34:14 +00:00
Amazon Drive, formerly known as Amazon Cloud Drive, is a cloud storage
service run by Amazon for consumers.
2015-09-02 22:37:42 +00:00
2018-07-09 15:34:14 +00:00
## Status
**Important:** rclone supports Amazon Drive only if you have your own
set of API keys. Unfortunately the [Amazon Drive developer
program](https://developer.amazon.com/amazon-drive) is now closed to
new entries so if you don't already have your own set of keys you will
not be able to use rclone with Amazon Drive.
For the history on why rclone no longer has a set of Amazon Drive API
keys see [the forum ](https://forum.rclone.org/t/rclone-has-been-banned-from-amazon-drive/2314 ).
If you happen to know anyone who works at Amazon then please ask them
to re-instate rclone into the Amazon Drive developer program - thanks!
2021-10-14 13:40:18 +00:00
## Configuration
2015-09-02 22:37:42 +00:00
2016-07-11 11:42:44 +00:00
The initial setup for Amazon Drive involves getting a token from
2015-09-02 22:37:42 +00:00
Amazon which you need to do in your browser. `rclone config` walks
you through it.
2017-06-10 11:02:34 +00:00
The configuration process for Amazon Drive may involve using an [oauth
proxy](https://github.com/ncw/oauthproxy). This is used to keep the
Amazon credentials out of the source code. The proxy runs in Google's
very secure App Engine environment and doesn't store any credentials
which pass through it.
2018-07-09 15:34:14 +00:00
Since rclone doesn't currently have its own Amazon Drive credentials
so you will either need to have your own `client_id` and
2021-11-04 11:50:43 +00:00
`client_secret` with Amazon Drive, or use a third-party oauth proxy
2017-06-10 11:02:34 +00:00
in which case you will need to enter `client_id` , `client_secret` ,
`auth_url` and `token_url` .
Note also if you are not using Amazon's `auth_url` and `token_url` ,
(ie you filled in something for those) then if setting up on a remote
machine you can only use the [copying the config method of
configuration](https://rclone.org/remote_setup/#configuring-by-copying-the-config-file)
- `rclone authorize` will not work.
2015-09-02 22:37:42 +00:00
Here is an example of how to make a remote called `remote` . First run:
rclone config
This will guide you through an interactive setup process:
```
2021-11-01 20:34:46 +00:00
No remotes found, make a new one?
2015-09-02 22:37:42 +00:00
n) New remote
2017-06-10 11:02:34 +00:00
r) Rename remote
c) Copy remote
s) Set configuration password
2015-09-02 22:37:42 +00:00
q) Quit config
2017-06-10 11:02:34 +00:00
n/r/c/s/q> n
2015-09-02 22:37:42 +00:00
name> remote
2016-02-21 13:39:04 +00:00
Type of storage to configure.
Choose a number from below, or type in your own value
2019-08-26 09:47:17 +00:00
[snip]
XX / Amazon Drive
2016-02-21 13:39:04 +00:00
\ "amazon cloud drive"
2019-08-26 09:47:17 +00:00
[snip]
Storage> amazon cloud drive
2017-06-10 11:02:34 +00:00
Amazon Application Client Id - required.
client_id> your client ID goes here
Amazon Application Client Secret - required.
client_secret> your client secret goes here
Auth server URL - leave blank to use Amazon's.
auth_url> Optional auth URL
Token server url - leave blank to use Amazon's.
token_url> Optional token URL
2015-09-02 22:37:42 +00:00
Remote config
2017-06-10 11:02:34 +00:00
Make sure your Redirect URL is set to "http://127.0.0.1:53682/" in your custom config.
2022-12-07 19:44:28 +00:00
Use web browser to automatically authenticate rclone with remote?
* Say Y if the machine running rclone has a web browser you can use
* Say N if running rclone on a (remote) machine without web browser access
If not sure try Y. If Y failed, try N.
2017-01-09 05:09:19 +00:00
y) Yes
n) No
y/n> y
2015-09-11 12:26:51 +00:00
If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth
Log in and authorize rclone for access
Waiting for code...
Got code
2015-09-02 22:37:42 +00:00
--------------------
[remote]
2017-06-10 11:02:34 +00:00
client_id = your client ID goes here
client_secret = your client secret goes here
auth_url = Optional auth URL
token_url = Optional token URL
2015-09-02 22:37:42 +00:00
token = {"access_token":"xxxxxxxxxxxxxxxxxxxxxxx","token_type":"bearer","refresh_token":"xxxxxxxxxxxxxxxxxx","expiry":"2015-09-06T16:07:39.658438471+01:00"}
--------------------
y) Yes this is OK
e) Edit this remote
d) Delete this remote
y/e/d> y
```
2016-01-07 15:20:32 +00:00
See the [remote setup docs ](/remote_setup/ ) for how to set it up on a
machine with no Internet browser available.
2015-09-02 22:37:42 +00:00
Note that rclone runs a webserver on your local machine to collect the
2015-09-11 12:26:51 +00:00
token as returned from Amazon. This only runs from the moment it
opens your browser to the moment you get back the verification
2015-09-02 22:37:42 +00:00
code. This is on `http://127.0.0.1:53682/` and this it may require
you to unblock it temporarily if you are running a host firewall.
Once configured you can then use `rclone` like this,
2016-07-11 11:42:44 +00:00
List directories in top level of your Amazon Drive
2015-09-02 22:37:42 +00:00
rclone lsd remote:
2016-07-11 11:42:44 +00:00
List all the files in your Amazon Drive
2015-09-02 22:37:42 +00:00
rclone ls remote:
2016-07-11 11:42:44 +00:00
To copy a local directory to an Amazon Drive directory called backup
2015-09-02 22:37:42 +00:00
rclone copy /home/source remote:backup
2023-11-18 12:36:46 +00:00
### Modification times and hashes
2015-09-02 22:37:42 +00:00
2016-07-11 11:42:44 +00:00
Amazon Drive doesn't allow modification times to be changed via
2015-09-02 22:37:42 +00:00
the API so these won't be accurate or used for syncing.
2023-11-18 12:36:46 +00:00
It does support the MD5 hash algorithm, so for a more accurate sync,
you can use the `--checksum` flag.
2015-09-02 22:37:42 +00:00
2021-10-14 13:40:18 +00:00
### Restricted filename characters
2019-05-19 15:53:14 +00:00
| Character | Value | Replacement |
| --------- |:-----:|:-----------:|
| NUL | 0x00 | ␀ |
| / | 0x2F | / |
Invalid UTF-8 bytes will also be [replaced ](/overview/#invalid-utf8 ),
as they can't be used in JSON strings.
2021-10-14 13:40:18 +00:00
### Deleting files
2015-09-02 22:37:42 +00:00
Any files you delete with rclone will end up in the trash. Amazon
don't provide an API to permanently delete files, nor to empty the
trash, so you will have to do that with one of Amazon's apps or via
2021-11-04 11:50:43 +00:00
the Amazon Drive website. As of November 17, 2016, files are
2017-01-08 16:24:03 +00:00
automatically deleted by Amazon from the trash after 30 days.
2015-09-02 22:37:42 +00:00
2021-10-14 13:40:18 +00:00
### Using with non `.com` Amazon accounts
2016-10-18 16:33:41 +00:00
Let's say you usually use `amazon.co.uk` . When you authenticate with
rclone it will take you to an `amazon.com` page to log in. Your
`amazon.co.uk` email and password should work here just fine.
2020-05-22 11:22:52 +00:00
{{< rem autogenerated options start " - DO NOT EDIT - instead edit fs . RegInfo in backend / amazonclouddrive / amazonclouddrive . go then run make backenddocs " > }}
2021-11-01 15:42:05 +00:00
### Standard options
2018-10-01 19:48:54 +00:00
2022-07-09 17:08:20 +00:00
Here are the Standard options specific to amazon cloud drive (Amazon Drive).
2018-10-01 19:48:54 +00:00
#### --acd-client-id
2021-11-01 15:42:05 +00:00
OAuth Client Id.
2020-09-02 15:59:04 +00:00
Leave blank normally.
2018-10-01 19:48:54 +00:00
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: client_id
- Env Var: RCLONE_ACD_CLIENT_ID
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2018-10-01 19:48:54 +00:00
#### --acd-client-secret
2021-11-01 15:42:05 +00:00
OAuth Client Secret.
2020-09-02 15:59:04 +00:00
Leave blank normally.
2018-10-01 19:48:54 +00:00
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: client_secret
- Env Var: RCLONE_ACD_CLIENT_SECRET
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2018-10-01 19:48:54 +00:00
2021-11-01 15:42:05 +00:00
### Advanced options
2018-10-01 19:48:54 +00:00
2022-07-09 17:08:20 +00:00
Here are the Advanced options specific to amazon cloud drive (Amazon Drive).
2018-10-01 19:48:54 +00:00
2020-09-02 15:59:04 +00:00
#### --acd-token
OAuth Access Token as a JSON blob.
2022-03-18 12:29:54 +00:00
Properties:
2020-09-02 15:59:04 +00:00
- Config: token
- Env Var: RCLONE_ACD_TOKEN
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2020-09-02 15:59:04 +00:00
2018-10-01 19:48:54 +00:00
#### --acd-auth-url
Auth server URL.
2021-11-01 15:42:05 +00:00
2020-09-02 15:59:04 +00:00
Leave blank to use the provider defaults.
2018-10-01 19:48:54 +00:00
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: auth_url
- Env Var: RCLONE_ACD_AUTH_URL
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2018-10-01 19:48:54 +00:00
#### --acd-token-url
Token server url.
2021-11-01 15:42:05 +00:00
2020-09-02 15:59:04 +00:00
Leave blank to use the provider defaults.
2018-10-01 19:48:54 +00:00
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: token_url
- Env Var: RCLONE_ACD_TOKEN_URL
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2018-10-01 19:48:54 +00:00
#### --acd-checkpoint
Checkpoint for internal polling (debug).
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: checkpoint
- Env Var: RCLONE_ACD_CHECKPOINT
- Type: string
2022-03-18 12:29:54 +00:00
- Required: false
2018-10-01 19:48:54 +00:00
#### --acd-upload-wait-per-gb
2021-03-02 19:11:57 +00:00
Additional time per GiB to wait after a failed complete upload to see if it appears.
2018-10-01 19:48:54 +00:00
Sometimes Amazon Drive gives an error when a file has been fully
uploaded but the file appears anyway after a little while. This
2021-03-02 19:11:57 +00:00
happens sometimes for files over 1 GiB in size and nearly every time for
files bigger than 10 GiB. This parameter controls the time rclone waits
2018-10-01 19:48:54 +00:00
for the file to appear.
2021-03-02 19:11:57 +00:00
The default value for this parameter is 3 minutes per GiB, so by
default it will wait 3 minutes for every GiB uploaded to see if the
2018-10-01 19:48:54 +00:00
file appears.
You can disable this feature by setting it to 0. This may cause
conflict errors as rclone retries the failed upload but the file will
most likely appear correctly eventually.
These values were determined empirically by observing lots of uploads
of big files for a range of file sizes.
Upload with the "-v" flag to see more info about what rclone is doing
in this situation.
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: upload_wait_per_gb
- Env Var: RCLONE_ACD_UPLOAD_WAIT_PER_GB
- Type: Duration
- Default: 3m0s
#### --acd-templink-threshold
Files >= this size will be downloaded via their tempLink.
Files this size or more will be downloaded via their "tempLink". This
is to work around a problem with Amazon Drive which blocks downloads
2021-07-20 18:45:41 +00:00
of files bigger than about 10 GiB. The default for this is 9 GiB which
2018-10-01 19:48:54 +00:00
shouldn't need to be changed.
To download files above this threshold, rclone requests a "tempLink"
which downloads the file through a temporary URL directly from the
underlying S3 storage.
2022-03-18 12:29:54 +00:00
Properties:
2018-10-01 19:48:54 +00:00
- Config: templink_threshold
- Env Var: RCLONE_ACD_TEMPLINK_THRESHOLD
- Type: SizeSuffix
2021-07-20 18:45:41 +00:00
- Default: 9Gi
2018-10-01 19:48:54 +00:00
2020-02-01 10:31:42 +00:00
#### --acd-encoding
2022-03-18 12:29:54 +00:00
The encoding for the backend.
2020-02-01 10:31:42 +00:00
2021-11-01 15:42:05 +00:00
See the [encoding section in the overview ](/overview/#encoding ) for more info.
2020-02-01 10:31:42 +00:00
2022-03-18 12:29:54 +00:00
Properties:
2020-02-01 10:31:42 +00:00
- Config: encoding
- Env Var: RCLONE_ACD_ENCODING
2023-11-26 15:59:12 +00:00
- Type: Encoding
2020-02-01 10:31:42 +00:00
- Default: Slash,InvalidUtf8,Dot
2020-05-22 11:22:52 +00:00
{{< rem autogenerated options stop > }}
2016-08-18 16:49:49 +00:00
2021-10-14 13:40:18 +00:00
## Limitations
2015-09-02 22:37:42 +00:00
2016-07-11 11:42:44 +00:00
Note that Amazon Drive is case insensitive so you can't have a
2015-09-02 22:37:42 +00:00
file called "Hello.doc" and one called "hello.doc".
2016-07-11 11:42:44 +00:00
Amazon Drive has rate limiting so you may notice errors in the
2015-09-02 22:37:42 +00:00
sync (429 errors). rclone will automatically retry the sync up to 3
times by default (see `--retries` flag) which should hopefully work
around this problem.
2016-01-04 12:23:33 +00:00
2016-07-11 11:42:44 +00:00
Amazon Drive has an internal limit of file sizes that can be uploaded
to the service. This limit is not officially published, but all files
larger than this will fail.
2016-01-04 12:23:33 +00:00
2021-03-02 19:11:57 +00:00
At the time of writing (Jan 2016) is in the area of 50 GiB per file.
2016-01-04 12:23:33 +00:00
This means that larger files are likely to fail.
2017-03-19 00:18:04 +00:00
Unfortunately there is no way for rclone to see that this failure is
2016-01-04 12:23:33 +00:00
because of file size, so it will retry the operation, as any other
2016-11-17 17:30:49 +00:00
failure. To avoid this problem, use `--max-size 50000M` option to limit
2016-11-27 18:18:47 +00:00
the maximum size of uploaded files. Note that `--max-size` does not split
files into segments, it only ignores files over this size.
2020-11-27 14:08:52 +00:00
`rclone about` is not supported by the Amazon Drive backend. Backends without
this capability cannot determine free space for an rclone mount or
use policy `mfs` (most free space) as a member of an rclone union
remote.
2022-05-13 22:06:45 +00:00
See [List of backends that do not support rclone about ](https://rclone.org/overview/#optional-features ) and [rclone about ](https://rclone.org/commands/rclone_about/ )
2020-11-27 14:08:52 +00:00