git-annex-renameremote(1)

git-annex-renameremote1

Changes name of a special remote

Usage

git {annex renameremote name | uuid | desc newname}

Overview

Changes the name that is used to enable a special remote.

Normally the current name is used to identify the special remote to rename, but its uuid or description can also be used.

This is especially useful when an old special remote used a name, and now you want to use that name for a new special remote. git annex initremote won't let you create a remote with a conflicting name, so rename the old remote first.

git annex renameremote phone lost-phone
git annex initremote phone ...

This only updates the name that git-annex has stored for use by git annex enableremote. It does not update the git config stanza for the special remote to use the new name, but of course you can edit the git config if you want to rename it there.

Options

The git-annex-common-options(1) can be used.

Releases

4 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12
  3. 13–Arch

Author

Joey Hess <[email protected]>

From git-annex 10.20261026-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.