"rsync for cloud storage" - Google Drive, S3, Dropbox, Backblaze B2, One Drive, Swift, Hubic, Wasabi, Google Cloud Storage, Azure Blob, Azure Files, Yandex Files
Go azure-blobazure-blob-storageazure-filesbackblaze-b2cloud-storagedropboxencryptionftpfuse-filesystemgogolanggoogle-cloud-storagegoogle-driveonedriveopenstack-swiftrclones3sftpsyncwebdav
docs: update remote setup page
albertony091fe9e45348
diff --git a/docs/content/remote_setup.md b/docs/content/remote_setup.mdindex 639c303a1..e5c1cd052 100644--- a/docs/content/remote_setup.md+++ b/docs/content/remote_setup.md@@ -8,20 +8,21 @@ description: "Configuring rclone up on a remote / headless machine"Some of the configurations (those involving oauth2) require aninternet-connected web browser.-If you are trying to set rclone up on a remote or headless box with no-browser available on it (e.g. a NAS or a server in a datacenter) then-you will need to use an alternative means of configuration. There are-two ways of doing it, described below.+If you are trying to set rclone up on a remote or headless machine with no+browser available on it (e.g. a NAS or a server in a datacenter), then+you will need to use an alternative means of configuration. There are+three ways of doing it, described below.## Configuring using rclone authorize-On the headless box run `rclone` config but answer `N` to the `Use auto config?`-question.+On the headless machine run [rclone config](/commands/rclone_config), but+answer `N` to the question `Use web browser to automatically authenticate rclone with remote?`.```text-Use auto config?- * Say Y if not sure- * Say N if you are working on a remote or headless machine+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.y) Yes (default)n) No@@ -33,33 +34,35 @@ a web browser available.For more help and alternate methods see: https://rclone.org/remote_setup/Execute the following on the machine with the web browser (same rcloneversion recommended):-rclone authorize "onedrive"+ rclone authorize "onedrive"Then paste the result.Enter a value.config_token>```-Then on your main desktop machine+Then on your main desktop machine, run [rclone authorize](/commands/rclone_authorize/).```textrclone authorize "onedrive"-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...+NOTICE: Make sure your Redirect URL is set to "http://localhost:53682/" in your custom config.+NOTICE: If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx+NOTICE: Log in and authorize rclone for access+NOTICE: Waiting for code...+Got codePaste the following into your remote machine --->SECRET_TOKEN<---End paste```-Then back to the headless box, paste in the code+Then back to the headless machine, paste in the code.```textconfig_token> SECRET_TOKEN--------------------[acd12]-client_id =-client_secret =+client_id =+client_secret =token = SECRET_TOKEN--------------------y) Yes this is OK@@ -70,18 +73,19 @@ y/e/d>## Configuring by copying the config file-Rclone stores all of its config in a single configuration file. This-can easily be copied to configure a remote rclone.+Rclone stores all of its configuration in a single file. This can easily be+copied to configure a remote rclone (although some backends does not support+reusing the same configuration, consult your backend documentation to be+sure).-So first configure rclone on your desktop machine with+Start by running [rclone config](/commands/rclone_config) to create the+configuration file on your desktop machine.```shrclone config```-to set up the config file.--Find the config file by running `rclone config file`, for example+Then locate the file by running [rclone config file](/commands/rclone_config_file).```sh$ rclone config file@@ -89,31 +93,37 @@ Configuration file is stored at:/home/user/.rclone.conf```-Now transfer it to the remote box (scp, cut paste, ftp, sftp, etc.) and-place it in the correct place (use `rclone config file` on the remote-box to find out where).+Finally, transfer the file to the remote machine (scp, cut paste, ftp, sftp, etc.)+and place it in the correct location (use [rclone config file](/commands/rclone_config_file)+on the remote machine to find out where).## Configuring using SSH Tunnel-Linux and MacOS users can utilize SSH Tunnel to redirect the headless box-port 53682 to local machine by using the following command:+If you have an SSH client installed on your local machine, you can set up an+SSH tunnel to redirect the port 53682 into the headless machine by using the+following command:```shssh -L localhost:53682:localhost:53682 username@remote_server```-Then on the headless box run `rclone config` and answer `Y` to the-`Use auto config?` question.+Then on the headless machine run [rclone config](/commands/rclone_config) and+answer `Y` to the question `Use web browser to automatically authenticate rclone with remote?`.```text-Use auto config?- * Say Y if not sure- * Say N if you are working on a remote or headless machine+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.y) Yes (default)n) Noy/n> y+NOTICE: Make sure your Redirect URL is set to "http://localhost:53682/" in your custom config.+NOTICE: If your browser doesn't open automatically go to the following link: http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx+NOTICE: Log in and authorize rclone for access+NOTICE: Waiting for code...```-Then copy and paste the auth url `http://127.0.0.1:53682/auth?state=xxxxxxxxxxxx`-to the browser on your local machine, complete the auth and it is done.+Finally, copy and paste the presented URL `http://127.0.0.1:53682/auth?state=xxxxxxxxxxxxxxxxxxxxxx`+to the browser on your local machine, complete the auth and you are done.