v1.69 beta

iCloud Drive

Configuration

The initial setup for an iCloud Drive backend involves getting a trust token/session. This can be done by simply using the regular iCloud password, and accepting the code prompt on another iCloud connected device.

IMPORTANT: At the moment an app specific password won’t be accepted. Only use your regular password and 2FA.

rclone config walks you through the token creation. The trust token is valid for 30 days. After which you will have to reauthenticate with rclone reconnect or rclone config.

Here is an example of how to make a remote called iclouddrive. First run:

  1.  rclone config

This will guide you through an interactive setup process:

  1. No remotes found, make a new one?
  2. n) New remote
  3. s) Set configuration password
  4. q) Quit config
  5. n/s/q> n
  6. name> iclouddrive
  7. Option Storage.
  8. Type of storage to configure.
  9. Choose a number from below, or type in your own value.
  10. [snip]
  11. XX / iCloud Drive
  12.    \ (iclouddrive)
  13. [snip]
  14. Storage> iclouddrive
  15. Option apple_id.
  16. Apple ID.
  17. Enter a value.
  18. apple_id> APPLEID  
  19. Option password.
  20. Password.
  21. Choose an alternative below.
  22. y) Yes, type in my own password
  23. g) Generate random password
  24. y/g> y
  25. Enter the password:
  26. password:
  27. Confirm the password:
  28. password:
  29. Edit advanced config?
  30. y) Yes
  31. n) No (default)
  32. y/n> n
  33. Option config_2fa.
  34. Two-factor authentication: please enter your 2FA code
  35. Enter a value.
  36. config_2fa> 2FACODE
  37. Remote config
  38. --------------------
  39. [koofr]
  40. - type: iclouddrive
  41. - apple_id: APPLEID
  42. - password: *** ENCRYPTED ***
  43. - cookies: ****************************
  44. - trust_token: ****************************
  45. --------------------
  46. y) Yes this is OK (default)
  47. e) Edit this remote
  48. d) Delete this remote
  49. y/e/d> y

Advanced Data Protection

ADP is currently unsupported and need to be disabled

Standard options

Here are the Standard options specific to iclouddrive (iCloud Drive).

--iclouddrive-apple-id

Apple ID.

Properties:

  • Config: apple_id
  • Env Var: RCLONE_ICLOUDDRIVE_APPLE_ID
  • Type: string
  • Required: true

--iclouddrive-password

Password.

NB Input to this must be obscured - see rclone obscure.

Properties:

  • Config: password
  • Env Var: RCLONE_ICLOUDDRIVE_PASSWORD
  • Type: string
  • Required: true

--iclouddrive-trust-token

Trust token (internal use)

Properties:

  • Config: trust_token
  • Env Var: RCLONE_ICLOUDDRIVE_TRUST_TOKEN
  • Type: string
  • Required: false

--iclouddrive-cookies

cookies (internal use only)

Properties:

  • Config: cookies
  • Env Var: RCLONE_ICLOUDDRIVE_COOKIES
  • Type: string
  • Required: false

Advanced options

Here are the Advanced options specific to iclouddrive (iCloud Drive).

--iclouddrive-client-id

Client id

Properties:

  • Config: client_id
  • Env Var: RCLONE_ICLOUDDRIVE_CLIENT_ID
  • Type: string
  • Default: “d39ba9916b7251055b22c7f910e2ea796ee65e98b2ddecea8f5dde8d9d1a815d”

--iclouddrive-encoding

The encoding for the backend.

See the encoding section in the overview for more info.

Properties:

  • Config: encoding
  • Env Var: RCLONE_ICLOUDDRIVE_ENCODING
  • Type: Encoding
  • Default: Slash,BackSlash,Del,Ctl,InvalidUtf8,Dot

--iclouddrive-description

Description of the remote.

Properties:

  • Config: description
  • Env Var: RCLONE_ICLOUDDRIVE_DESCRIPTION
  • Type: string
  • Required: false