extern/rclone
1
0
Fork 0
mirror of https://github.com/rclone/rclone.git synced 2024-12-23 15:38:57 +01:00
Code Issues Packages Projects Releases Wiki Activity

Update remote docs to show correct setup process

Browse Source
This commit is contained in:
emyarod 2017-01-08 21:09:19 -08:00 committed by Nick Craig-Wood
parent 499766f6ab
commit 3c87a0d0dc
11 changed files with 216 additions and 175 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
docs/content/amazonclouddrive.md
View File

@ -31,40 +31,48 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 1 Storage> 1
Amazon Application Client Id - leave blank normally. Amazon Application Client Id - leave blank normally.
client_id> client_id>
Amazon Application Client Secret - leave blank normally. Amazon Application Client Secret - leave blank normally.
client_secret> client_secret>
Remote config Remote config
Use auto config?
* Say Y if not sure
* Say N if you are working on a remote or headless machine
y) Yes
n) No
y/n> y
If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth 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 Log in and authorize rclone for access
Waiting for code... Waiting for code...
Got code Got code
-------------------- --------------------
[remote] [remote]
client_id = client_id =
client_secret = client_secret =
token = {"access_token":"xxxxxxxxxxxxxxxxxxxxxxx","token_type":"bearer","refresh_token":"xxxxxxxxxxxxxxxxxx","expiry":"2015-09-06T16:07:39.658438471+01: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 y) Yes this is OK
@ -173,7 +181,7 @@ larger than this will fail.
At the time of writing (Jan 2016) is in the area of 50GB per file. At the time of writing (Jan 2016) is in the area of 50GB per file.
This means that larger files are likely to fail. This means that larger files are likely to fail.
Unfortunatly there is no way for rclone to see that this failure is Unfortunatly there is no way for rclone to see that this failure is
because of file size, so it will retry the operation, as any other because of file size, so it will retry the operation, as any other
failure. To avoid this problem, use `--max-size 50000M` option to limit failure. To avoid this problem, use `--max-size 50000M` option to limit
the maximum size of uploaded files. Note that `--max-size` does not split the maximum size of uploaded files. Note that `--max-size` does not split

22
docs/content/b2.md
View File

@ -30,25 +30,27 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 3 Storage> 3
Account ID Account ID
@ -56,13 +58,13 @@ account> 123456789abc
Application Key Application Key
key> 0123456789abcdef0123456789abcdef0123456789 key> 0123456789abcdef0123456789abcdef0123456789
Endpoint for the service - leave blank normally. Endpoint for the service - leave blank normally.
endpoint> endpoint>
Remote config Remote config
-------------------- --------------------
[remote] [remote]
account = 123456789abc account = 123456789abc
key = 0123456789abcdef0123456789abcdef0123456789 key = 0123456789abcdef0123456789abcdef0123456789
endpoint = endpoint =
-------------------- --------------------
y) Yes this is OK y) Yes this is OK
e) Edit this remote e) Edit this remote

2
docs/content/crypt.md
View File

@ -61,7 +61,7 @@ Choose a number from below, or type in your own value
Storage> 5 Storage> 5
Remote to encrypt/decrypt. Remote to encrypt/decrypt.
Normally should contain a ':' and a path, eg "myremote:path/to/dir", Normally should contain a ':' and a path, eg "myremote:path/to/dir",
"myremote:bucket" or "myremote:" "myremote:bucket" or maybe "myremote:" (not recommended).
remote> remote:path remote> remote:path
How to encrypt the filenames. How to encrypt the filenames.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value

30
docs/content/drive.md
View File

@ -31,31 +31,33 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 6 Storage> 7
Google Application Client Id - leave blank normally. Google Application Client Id - leave blank normally.
client_id> client_id>
Google Application Client Secret - leave blank normally. Google Application Client Secret - leave blank normally.
client_secret> client_secret>
Remote config Remote config
Use auto config? Use auto config?
* Say Y if not sure * Say Y if not sure
@ -69,8 +71,8 @@ Waiting for code...
Got code Got code
-------------------- --------------------
[remote] [remote]
client_id = client_id =
client_secret = client_secret =
token = {"AccessToken":"xxxx.x.xxxxx_xxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","RefreshToken":"1/xxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxx","Expiry":"2014-03-16T13:57:58.955387075Z","Extra":null} token = {"AccessToken":"xxxx.x.xxxxx_xxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","RefreshToken":"1/xxxxxxxxxxxxxxxx_xxxxxxxxxxxxxxxxxxxxxxxxxx","Expiry":"2014-03-16T13:57:58.955387075Z","Extra":null}
-------------------- --------------------
y) Yes this is OK y) Yes this is OK
@ -186,7 +188,7 @@ Here are the possible extensions with their corresponding mime types.
| epub | application/epub+zip | E-book format | | epub | application/epub+zip | E-book format |
| html | text/html | An HTML Document | | html | text/html | An HTML Document |
| jpg | image/jpeg | A JPEG Image File | | jpg | image/jpeg | A JPEG Image File |
| odp | application/vnd.oasis.opendocument.presentation | Openoffice Presentation | | odp | application/vnd.oasis.opendocument.presentation | Openoffice Presentation |
| ods | application/vnd.oasis.opendocument.spreadsheet | Openoffice Spreadsheet | | ods | application/vnd.oasis.opendocument.spreadsheet | Openoffice Spreadsheet |
| ods | application/x-vnd.oasis.opendocument.spreadsheet | Openoffice Spreadsheet | | ods | application/x-vnd.oasis.opendocument.spreadsheet | Openoffice Spreadsheet |
| odt | application/vnd.oasis.opendocument.text | Openoffice Document | | odt | application/vnd.oasis.opendocument.text | Openoffice Document |

26
docs/content/dropbox.md
View File

@ -32,39 +32,41 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 4 Storage> 4
Dropbox App Key - leave blank normally. Dropbox App Key - leave blank normally.
app_key> app_key>
Dropbox App Secret - leave blank normally. Dropbox App Secret - leave blank normally.
app_secret> app_secret>
Remote config Remote config
Please visit: Please visit:
https://www.dropbox.com/1/oauth2/authorize?client_id=XXXXXXXXXXXXXXX&response_type=code https://www.dropbox.com/1/oauth2/authorize?client_id=XXXXXXXXXXXXXXX&response_type=code
Enter the code: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXX Enter the code: XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXXXXXXXX
-------------------- --------------------
[remote] [remote]
app_key = app_key =
app_secret = app_secret =
token = XXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX token = XXXXXXXXXXXXXXXXXXXXXXXXXXXXX_XXXX_XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-------------------- --------------------
y) Yes this is OK y) Yes this is OK

75
docs/content/googlecloudstorage.md
View File

@ -30,65 +30,66 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 5 Storage> 6
Google Application Client Id - leave blank normally. Google Application Client Id - leave blank normally.
client_id> client_id>
Google Application Client Secret - leave blank normally. Google Application Client Secret - leave blank normally.
client_secret> client_secret>
Project number optional - needed only for list/create/delete buckets - see your developer console. Project number optional - needed only for list/create/delete buckets - see your developer console.
project_number> 12345678 project_number> 12345678
Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login. Service Account Credentials JSON file path - needed only if you want use SA instead of interactive login.
service_account_file> service_account_file>
Access Control List for new objects. Access Control List for new objects.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
* Object owner gets OWNER access, and all Authenticated Users get READER access. 1 / Object owner gets OWNER access, and all Authenticated Users get READER access.
1) authenticatedRead \ "authenticatedRead"
* Object owner gets OWNER access, and project team owners get OWNER access. 2 / Object owner gets OWNER access, and project team owners get OWNER access.
2) bucketOwnerFullControl \ "bucketOwnerFullControl"
* Object owner gets OWNER access, and project team owners get READER access. 3 / Object owner gets OWNER access, and project team owners get READER access.
3) bucketOwnerRead \ "bucketOwnerRead"
* Object owner gets OWNER access [default if left blank]. 4 / Object owner gets OWNER access [default if left blank].
4) private \ "private"
* Object owner gets OWNER access, and project team members get access according to their roles. 5 / Object owner gets OWNER access, and project team members get access according to their roles.
5) projectPrivate \ "projectPrivate"
* Object owner gets OWNER access, and all Users get READER access. 6 / Object owner gets OWNER access, and all Users get READER access.
6) publicRead \ "publicRead"
object_acl> 4 object_acl> 4
Access Control List for new buckets. Access Control List for new buckets.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
* Project team owners get OWNER access, and all Authenticated Users get READER access. 1 / Project team owners get OWNER access, and all Authenticated Users get READER access.
1) authenticatedRead \ "authenticatedRead"
* Project team owners get OWNER access [default if left blank]. 2 / Project team owners get OWNER access [default if left blank].
2) private \ "private"
* Project team members get access according to their roles. 3 / Project team members get access according to their roles.
3) projectPrivate \ "projectPrivate"
* Project team owners get OWNER access, and all Users get READER access. 4 / Project team owners get OWNER access, and all Users get READER access.
4) publicRead \ "publicRead"
* Project team owners get OWNER access, and all Users get WRITER access. 5 / Project team owners get OWNER access, and all Users get WRITER access.
5) publicReadWrite \ "publicReadWrite"
bucket_acl> 2 bucket_acl> 2
Remote config Remote config
Remote config
Use auto config? Use auto config?
* Say Y if not sure * Say Y if not sure
* Say N if you are working on a remote or headless machine or Y didn't work * Say N if you are working on a remote or headless machine or Y didn't work
@ -102,8 +103,8 @@ Got code
-------------------- --------------------
[remote] [remote]
type = google cloud storage type = google cloud storage
client_id = client_id =
client_secret = client_secret =
token = {"AccessToken":"xxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","RefreshToken":"x/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxx","Expiry":"2014-07-17T20:49:14.929208288+01:00","Extra":null} token = {"AccessToken":"xxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","RefreshToken":"x/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx_xxxxxxxxx","Expiry":"2014-07-17T20:49:14.929208288+01:00","Extra":null}
project_number = 12345678 project_number = 12345678
object_acl = private object_acl = private

28
docs/content/hubic.md
View File

@ -30,31 +30,33 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 7 Storage> 8
Hubic Client Id - leave blank normally. Hubic Client Id - leave blank normally.
client_id> client_id>
Hubic Client Secret - leave blank normally. Hubic Client Secret - leave blank normally.
client_secret> client_secret>
Remote config Remote config
Use auto config? Use auto config?
* Say Y if not sure * Say Y if not sure
@ -68,8 +70,8 @@ Waiting for code...
Got code Got code
-------------------- --------------------
[remote] [remote]
client_id = client_id =
client_secret = client_secret =
token = {"access_token":"XXXXXX"} token = {"access_token":"XXXXXX"}
-------------------- --------------------
y) Yes this is OK y) Yes this is OK

52
docs/content/onedrive.md
View File

@ -1,17 +1,17 @@
--- ---
title: "Microsoft One Drive" title: "Microsoft OneDrive"
description: "Rclone docs for Microsoft One Drive" description: "Rclone docs for Microsoft OneDrive"
date: "2015-10-14" date: "2015-10-14"
--- ---
<i class="fa fa-windows"></i> Microsoft One Drive <i class="fa fa-windows"></i> Microsoft OneDrive
----------------------------------------- -----------------------------------------
Paths are specified as `remote:path` Paths are specified as `remote:path`
Paths may be as deep as required, eg `remote:directory/subdirectory`. Paths may be as deep as required, eg `remote:directory/subdirectory`.
The initial setup for One Drive involves getting a token from The initial setup for OneDrive involves getting a token from
Microsoft which you need to do in your browser. `rclone config` walks Microsoft which you need to do in your browser. `rclone config` walks
you through it. you through it.
@ -31,31 +31,33 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 9 Storage> 10
Microsoft App Client Id - leave blank normally. Microsoft App Client Id - leave blank normally.
client_id> client_id>
Microsoft App Client Secret - leave blank normally. Microsoft App Client Secret - leave blank normally.
client_secret> client_secret>
Remote config Remote config
Use auto config? Use auto config?
* Say Y if not sure * Say Y if not sure
@ -69,8 +71,8 @@ Waiting for code...
Got code Got code
-------------------- --------------------
[remote] [remote]
client_id = client_id =
client_secret = client_secret =
token = {"access_token":"XXXXXX"} token = {"access_token":"XXXXXX"}
-------------------- --------------------
y) Yes this is OK y) Yes this is OK
@ -90,21 +92,21 @@ you to unblock it temporarily if you are running a host firewall.
Once configured you can then use `rclone` like this, Once configured you can then use `rclone` like this,
List directories in top level of your One Drive List directories in top level of your OneDrive
rclone lsd remote: rclone lsd remote:
List all the files in your One Drive List all the files in your OneDrive
rclone ls remote: rclone ls remote:
To copy a local directory to an One Drive directory called backup To copy a local directory to an OneDrive directory called backup
rclone copy /home/source remote:backup rclone copy /home/source remote:backup
### Modified time and hashes ### ### Modified time and hashes ###
One Drive allows modification times to be set on objects accurate to 1 OneDrive allows modification times to be set on objects accurate to 1
second. These will be used to detect whether objects need syncing or second. These will be used to detect whether objects need syncing or
not. not.
@ -116,7 +118,7 @@ One drive supports SHA1 type hashes, so you can use `--checksum` flag.
Any files you delete with rclone will end up in the trash. Microsoft Any files you delete with rclone will end up in the trash. Microsoft
doesn't provide an API to permanently delete files, nor to empty the doesn't provide an API to permanently delete files, nor to empty the
trash, so you will have to do that with one of Microsoft's apps or via trash, so you will have to do that with one of Microsoft's apps or via
the One Drive website. the OneDrive website.
### Specific options ### ### Specific options ###
@ -135,14 +137,14 @@ is 10MB.
### Limitations ### ### Limitations ###
Note that One Drive is case insensitive so you can't have a Note that OneDrive is case insensitive so you can't have a
file called "Hello.doc" and one called "hello.doc". file called "Hello.doc" and one called "hello.doc".
Rclone only supports your default One Drive, and doesn't work with One Rclone only supports your default OneDrive, and doesn't work with One
Drive for business. Both these issues may be fixed at some point Drive for business. Both these issues may be fixed at some point
depending on user demand! depending on user demand!
There are quite a few characters that can't be in One Drive file There are quite a few characters that can't be in OneDrive file
names. These can't occur on Windows platforms, but on non-Windows names. These can't occur on Windows platforms, but on non-Windows
platforms they are common. Rclone will map these names to and from an platforms they are common. Rclone will map these names to and from an
identical looking unicode equivalent. For example if a file has a `?` identical looking unicode equivalent. For example if a file has a `?`

51
docs/content/s3.md
View File

@ -26,25 +26,27 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 2 Storage> 2
Get AWS credentials from runtime (environment variables or EC2 meta data if no env vars). Only applies if access_key_id and secret_access_key is blank. Get AWS credentials from runtime (environment variables or EC2 meta data if no env vars). Only applies if access_key_id and secret_access_key is blank.
@ -85,21 +87,27 @@ Choose a number from below, or type in your own value
/ Asia Pacific (Tokyo) Region / Asia Pacific (Tokyo) Region
8 | Needs location constraint ap-northeast-1. 8 | Needs location constraint ap-northeast-1.
\ "ap-northeast-1" \ "ap-northeast-1"
/ Asia Pacific (Seoul)
9 | Needs location constraint ap-northeast-2.
\ "ap-northeast-2"
/ Asia Pacific (Mumbai)
10 | Needs location constraint ap-south-1.
\ "ap-south-1"
/ South America (Sao Paulo) Region / South America (Sao Paulo) Region
9 | Needs location constraint sa-east-1. 11 | Needs location constraint sa-east-1.
\ "sa-east-1" \ "sa-east-1"
/ If using an S3 clone that only understands v2 signatures / If using an S3 clone that only understands v2 signatures
10 | eg Ceph/Dreamhost 12 | eg Ceph/Dreamhost
| set this and make sure you set the endpoint. | set this and make sure you set the endpoint.
\ "other-v2-signature" \ "other-v2-signature"
/ If using an S3 clone that understands v4 signatures set this / If using an S3 clone that understands v4 signatures set this
11 | and make sure you set the endpoint. 13 | and make sure you set the endpoint.
\ "other-v4-signature" \ "other-v4-signature"
region> 1 region> 1
Endpoint for S3 API. Endpoint for S3 API.
Leave blank if using AWS to use the default endpoint for the region. Leave blank if using AWS to use the default endpoint for the region.
Specify if using an S3 clone such as Ceph. Specify if using an S3 clone such as Ceph.
endpoint> endpoint>
Location constraint - must be set to match the Region. Used when creating buckets only. Location constraint - must be set to match the Region. Used when creating buckets only.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Empty for US Region, Northern Virginia or Pacific Northwest. 1 / Empty for US Region, Northern Virginia or Pacific Northwest.
@ -118,7 +126,11 @@ Choose a number from below, or type in your own value
\ "ap-southeast-2" \ "ap-southeast-2"
8 / Asia Pacific (Tokyo) Region. 8 / Asia Pacific (Tokyo) Region.
\ "ap-northeast-1" \ "ap-northeast-1"
9 / South America (Sao Paulo) Region. 9 / Asia Pacific (Seoul)
\ "ap-northeast-2"
10 / Asia Pacific (Mumbai)
\ "ap-south-1"
11 / South America (Sao Paulo) Region.
\ "sa-east-1" \ "sa-east-1"
location_constraint> 1 location_constraint> 1
Canned ACL used when creating buckets and/or storing objects in S3. Canned ACL used when creating buckets and/or storing objects in S3.
@ -165,8 +177,11 @@ env_auth = false
access_key_id = access_key access_key_id = access_key
secret_access_key = secret_key secret_access_key = secret_key
region = us-east-1 region = us-east-1
endpoint = endpoint =
location_constraint = location_constraint =
acl = private
server_side_encryption =
storage_class =
-------------------- --------------------
y) Yes this is OK y) Yes this is OK
e) Edit this remote e) Edit this remote
@ -364,7 +379,7 @@ access_key_id> WLGDGYAQYIGI833EV05A
secret_access_key> BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF secret_access_key> BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF
region> us-east-1 region> us-east-1
endpoint> http://10.0.0.3:9000 endpoint> http://10.0.0.3:9000
location_constraint> location_constraint>
server_side_encryption> server_side_encryption>
``` ```
@ -377,8 +392,8 @@ access_key_id = WLGDGYAQYIGI833EV05A
secret_access_key = BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF secret_access_key = BYvgJM101sHngl2uzjXS/OBF/aMxAN06JrJ3qJlF
region = us-east-1 region = us-east-1
endpoint = http://10.0.0.3:9000 endpoint = http://10.0.0.3:9000
location_constraint = location_constraint =
server_side_encryption = server_side_encryption =
``` ```
Minio doesn't support all the features of S3 yet. In particular it Minio doesn't support all the features of S3 yet. In particular it

43
docs/content/swift.md
View File

@ -32,27 +32,29 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 10 Storage> 11
User name to log in. User name to log in.
user> user_name user> user_name
API key or password. API key or password.
@ -74,25 +76,28 @@ Choose a number from below, or type in your own value
auth> 1 auth> 1
User domain - optional (v3 auth) User domain - optional (v3 auth)
domain> Default domain> Default
Tenant name - optional Tenant name - optional for v1 auth, required otherwise
tenant> tenant> tenant_name
Tenant domain - optional (v3 auth) Tenant domain - optional (v3 auth)
tenant_domain> tenant_domain>
Region name - optional Region name - optional
region> region>
Storage URL - optional Storage URL - optional
storage_url> storage_url>
Remote config
AuthVersion - optional - set to (1,2,3) if your auth URL has no version AuthVersion - optional - set to (1,2,3) if your auth URL has no version
auth_version> auth_version>
Remote config
-------------------- --------------------
[remote] [remote]
user = user_name user = user_name
key = password_or_api_key key = password_or_api_key
auth = https://auth.api.rackspacecloud.com/v1.0 auth = https://auth.api.rackspacecloud.com/v1.0
tenant = domain = Default
region = tenant =
storage_url = tenant_domain =
region =
storage_url =
auth_version =
-------------------- --------------------
y) Yes this is OK y) Yes this is OK
e) Edit this remote e) Edit this remote
@ -160,7 +165,7 @@ system.
Above this size files will be chunked into a _segments container. The Above this size files will be chunked into a _segments container. The
default for this is 5GB which is its maximum value. default for this is 5GB which is its maximum value.
### Modified time ### ### Modified time ###
The modified time is stored as metadata on the object as The modified time is stored as metadata on the object as

28
docs/content/yandex.md
View File

@ -27,31 +27,33 @@ Type of storage to configure.
Choose a number from below, or type in your own value Choose a number from below, or type in your own value
1 / Amazon Drive 1 / Amazon Drive
\ "amazon cloud drive" \ "amazon cloud drive"
2 / Amazon S3 (also Dreamhost, Ceph) 2 / Amazon S3 (also Dreamhost, Ceph, Minio)
\ "s3" \ "s3"
3 / Backblaze B2 3 / Backblaze B2
\ "b2" \ "b2"
4 / Dropbox 4 / Dropbox
\ "dropbox" \ "dropbox"
5 / Google Cloud Storage (this is not Google Drive) 5 / Encrypt/Decrypt a remote
\ "crypt"
6 / Google Cloud Storage (this is not Google Drive)
\ "google cloud storage" \ "google cloud storage"
6 / Google Drive 7 / Google Drive
\ "drive" \ "drive"
7 / Hubic 8 / Hubic
\ "hubic" \ "hubic"
8 / Local Disk 9 / Local Disk
\ "local" \ "local"
9 / Microsoft OneDrive 10 / Microsoft OneDrive
\ "onedrive" \ "onedrive"
10 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH) 11 / Openstack Swift (Rackspace Cloud Files, Memset Memstore, OVH)
\ "swift" \ "swift"
11 / Yandex Disk 12 / Yandex Disk
\ "yandex" \ "yandex"
Storage> 11 Storage> 12
Yandex Client Id - leave blank normally. Yandex Client Id - leave blank normally.
client_id> client_id>
Yandex Client Secret - leave blank normally. Yandex Client Secret - leave blank normally.
client_secret> client_secret>
Remote config Remote config
Use auto config? Use auto config?
* Say Y if not sure * Say Y if not sure
@ -65,8 +67,8 @@ Waiting for code...
Got code Got code
-------------------- --------------------
[remote] [remote]
client_id = client_id =
client_secret = client_secret =
token = {"access_token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","token_type":"bearer","expiry":"2016-12-29T12:27:11.362788025Z"} token = {"access_token":"xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx","token_type":"bearer","expiry":"2016-12-29T12:27:11.362788025Z"}
-------------------- --------------------
y) Yes this is OK y) Yes this is OK