rclone/docs/content/commands/rclone_selfupdate.md

85 lines
3.6 KiB
Markdown
Raw Normal View History

2021-04-01 02:12:08 +08:00
---
title: "rclone selfupdate"
description: "Update the rclone binary."
2022-12-21 01:16:14 +08:00
versionIntroduced: v1.55
2021-04-01 02:12:08 +08:00
# autogenerated - DO NOT EDIT, instead edit the source code in cmd/selfupdate/ and as part of making a release run "make commanddocs"
---
# rclone selfupdate
Update the rclone binary.
## Synopsis
2023-09-11 22:59:44 +08:00
This command downloads the latest release of rclone and replaces the
currently running binary. The download is verified with a hashsum and
cryptographically signed signature; see [the release signing
docs](/release_signing/) for details.
2021-04-01 02:12:08 +08:00
If used without flags (or with implied `--stable` flag), this command
will install the latest stable release. However, some issues may be fixed
(or features added) only in the latest beta release. In such cases you should
run the command with the `--beta` flag, i.e. `rclone selfupdate --beta`.
You can check in advance what version would be installed by adding the
`--check` flag, then repeat the command without it when you are satisfied.
Sometimes the rclone team may recommend you a concrete beta or stable
rclone release to troubleshoot your issue or add a bleeding edge feature.
The `--version VER` flag, if given, will update to the concrete version
instead of the latest one. If you omit micro version from `VER` (for
example `1.53`), the latest matching micro version will be used.
Upon successful update rclone will print a message that contains a previous
version number. You will need it if you later decide to revert your update
for some reason. Then you'll have to note the previous version and run the
following command: `rclone selfupdate [--beta] OLDVER`.
If the old version contains only dots and digits (for example `v1.54.0`)
then it's a stable release so you won't need the `--beta` flag. Beta releases
have an additional information similar to `v1.54.0-beta.5111.06f1c0c61`.
(if you are a developer and use a locally built rclone, the version number
2021-06-08 23:57:04 +08:00
will end with `-DEV`, you will have to rebuild it as it obviously can't
2021-04-01 02:12:08 +08:00
be distributed).
If you previously installed rclone via a package manager, the package may
include local documentation or configure services. You may wish to update
with the flag `--package deb` or `--package rpm` (whichever is correct for
your OS) to update these too. This command with the default `--package zip`
will update only the rclone executable so the local manual may become
inaccurate after it.
2023-09-11 22:59:44 +08:00
The [rclone mount](/commands/rclone_mount/) command may
2021-04-01 02:12:08 +08:00
or may not support extended FUSE options depending on the build and OS.
`selfupdate` will refuse to update if the capability would be discarded.
Note: Windows forbids deletion of a currently running executable so this
command will rename the old executable to 'rclone.old.exe' upon success.
Please note that this command was not available before rclone version 1.55.
If it fails for you with the message `unknown command "selfupdate"` then
you will need to update manually following the install instructions located
at https://rclone.org/install/
```
rclone selfupdate [flags]
```
## Options
```
2021-11-01 23:42:05 +08:00
--beta Install beta release
--check Check for latest release, do not download
2021-04-01 02:12:08 +08:00
-h, --help help for selfupdate
--output string Save the downloaded binary at a given path (default: replace running binary)
--package string Package format: zip|deb|rpm (default: zip)
--stable Install stable release (this is the default)
--version string Install the given rclone version (default: latest)
```
2023-08-02 17:02:38 +08:00
2021-04-01 02:12:08 +08:00
See the [global flags page](/flags/) for global options not listed here.
2023-08-02 17:02:38 +08:00
# SEE ALSO
2021-04-01 02:12:08 +08:00
* [rclone](/commands/rclone/) - Show help for rclone commands, flags and backends.