Skip to content

Install: Rclone

desimaniac edited this page May 8, 2019 · 30 revisions

Rclone (by Nick Craig-Wood) is "rsync for the cloud". Basically, it is used to transfer data to or from a variety of supported cloud storage providers (eg Google Drive).

Rclone is used by Cloudplow and Backup to upload media and backup Cloudbox, respectively.

The guide below assumes you are using Google Drive.

If you would like to set this up with another cloud storage provider, but have not setup Rclone yet, then follow the guide below and replace all mentions of "Google Drive" with your preferred cloud storage provider's name.

If you already have Rclone configured, you can jump directly to the relevant section.

New Rclone Setup

  1. Run the following command:

    rclone config
    
  2. Type n for "New remote" and press Enter.

  3. For "name", type in google and press Enter.

  4. For "Type of storage", type in drive, or the corresponding number, and press Enter.

  5. Create a Google Drive API Client ID and Client Secret for Rclone.

  6. For "Google Application Client ID", paste the Client ID from Step #5, and press Enter.

  7. For "Google Application Client Secret", paste the Client Secret from Step #5, and press Enter.

  8. For the "Scope that rclone should use when requesting access from drive", type in drive, or the corresponding number (i.e. 1), to select "Full access all files, excluding Application Data Folder", and press Enter.

  9. For "ID of the root folder", leave blank and press Enter.

  10. For "Service Account Credentials JSON file path", leave blank and press Enter.

  11. For "Edit advanced config", type n and press Enter.

  12. For "Use auto config?", type n for "...remote or headless machine" and press Enter.

  13. In the next section, copy the link shown, and open it in your host PC's browser.

  14. If asked to login, use the Google Drive account you want to store your data in (see Prerequisites).

  15. Give access by clicking "Allow".

  16. You will now be given a "verification code". Copy it.

  17. Paste the "verification code" at the command prompt and press Enter.

  18. For "Configure this as a team drive?", type n and press Enter.

  19. To confirm that the remote details look OK, type y and press Enter.

  20. To exit, type q and press Enter.

Existing Rclone Setup

The default remote specified in settings.yml is google for Google Drive. If the Rclone remote in your config has the same name, then you are OK to skip this page and go on to the next.

If you are using Google Drive and the Rclone remote in your config has a different name, then you will need to either:

  • Rename your current Rclone remote to the default one (i.e. google). Instructions for this are below.

    Or

  • Edit the Rclone remote entry in settings.yml with yours.

If you prefer to use another cloud storage provider, you can add the name of the Rclone remote in to settings.yml.

Rename Existing Rclone Remote

To rename the Google Drive remote to google:

  1. Find and edit your Rclone configuration file.

    nano $(rclone config file | tail -n 1)
    
  2. Rename the Google Drive drive remote (name between the brackets) to google.

  3. It will now look like this:

    [google]
    type = drive
    client_id = 1234567890123-mjffsmxvendscftuvnyngkhegapovgnv.apps.googleusercontent.com
    client_secret = klflzftkrwuwuedesxzewsfz
    token = {"access_token":"ya30.gelftvrymioiilvdtfegfvhfgallrhocewjckdnnvmxdjpjzbdhkmgulvqhgbafkdtpottzthhnyzysxwlpf-38ikRIxZvimyoxyKdse$
    
  4. Save the file and exit: Ctrl + X Y Enter.

  5. Copy the config file to ~/.config/rclone/rclone.conf (if it isn't there already):

    cp -n $(rclone config file | tail -n 1) ~/.config/rclone/rclone.conf
    
  6. Give it the proper ownership and permissions. Replace user and group to match yours' (see here):

    sudo chown user:group ~/.config/rclone/rclone.conf
    sudo chmod 755 ~/.config/rclone/rclone.conf
    

Home

Basics

  1. Introduction
  2. Cloudbox Install Types
  3. Cloudbox Paths
  4. Accessing Cloudbox Apps

Prerequisites

  1. Overview
  2. Presumptions
  3. Server
  4. Domain Name
  5. Cloudflare
  6. Cloud Storage
  7. Plex / Emby - Account
  8. Usenet vs. BitTorrent

Install Cloudbox

Cloudbox
  1. Overview
  2. Dependencies
  3. Ansible Vault
  4. Settings
  5. Preinstall
  6. SSH
  7. Rclone
  8. Cloudbox
  9. Application Setup
    1. NZBGet
    2. ruTorrent
    3. NZBHydra2
    4. Jackett
    5. Plex Media Server
    6. Plex Autoscan
    7. Sonarr
    8. Radarr
    9. Lidarr
    10. PlexPy (Tautulli)
    11. Ombi
    12. Portainer
    13. Organizr

Install Mediabox / Feederbox

Feederbox (do this first)
  1. Overview
  2. Dependencies
  3. Ansible Vault
  4. Settings
  5. Preinstall
  6. SSH
  7. Rclone
  8. Feederbox
  9. Application Setup
    1. NZBGet
    2. ruTorrent
    3. NZBHydra2
    4. Jackett
    5. Sonarr
    6. Radarr
    7. Lidarr
    8. Portainer
    9. Organizr

Mediabox
  1. Overview
  2. Dependencies
  3. Ansible Vault
  4. Settings
  5. Preinstall
  6. SSH
  7. Rclone
  8. Mediabox
  9. Application Setup
    1. Feeder Mount
    2. Plex Media Server
    3. Plex Autoscan
    4. PlexPy (Tautulli)
    5. Ombi

Recommended Reading

Backup and Restore

More Information

Advanced Configuration

Experimental

Extras

Docs coming soon for ...

  • Radarr4K
  • Sonarr4K

Misc Guides

Reference

Troubleshooting

Links

Community Project

Clone this wiki locally
You can’t perform that action at this time.