From f76c6cc8931c7574a21b5ff7d03ae4ab82f59dcb Mon Sep 17 00:00:00 2001 From: albertony <12441419+albertony@users.noreply.github.com> Date: Tue, 16 Mar 2021 12:36:57 +0100 Subject: [PATCH] docs: describe how to bypass loading of config file Fixes #5125 --- docs/content/docs.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/docs/content/docs.md b/docs/content/docs.md index 101b14eed..81fc7e066 100644 --- a/docs/content/docs.md +++ b/docs/content/docs.md @@ -1722,7 +1722,7 @@ Configuration Encryption ------------------------ Your configuration file contains information for logging in to your cloud services. This means that you should keep your -`.rclone.conf` file in a secure location. +`rclone.conf` file in a secure location. If you are in an environment where that isn't possible, you can add a password to your configuration. This means that you will @@ -1828,6 +1828,16 @@ password prompts. To do that, pass the parameter of asking for a password if `RCLONE_CONFIG_PASS` doesn't contain a valid password, and `--password-command` has not been supplied. +Some rclone commands, such as `genautocomplete`, do not require configuration. +Nevertheless, rclone will read any configuration file found +according to the rules described [above](https://rclone.org/docs/#config-config-file). +If an encrypted configuration file is found, this means you will be prompted for +password (unless using `--password-command`). To avoid this, you can bypass +the loading of the configuration file by overriding the location with an empty +string `""` or the special value `/notfound`, or the os null device represented +by value `NUL` on Windows and `/dev/null` on Unix systems (before rclone +version 1.55 only this null device alternative was supported). +E.g. `rclone --config="" genautocomplete bash`. Developer options -----------------