---
name: "git-annex-renameremote"
section: "1"
platform: "linux"
package: "git-annex"
version: "10.20261026-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/git-annex-renameremote"
---

# git-annex-renameremote(1)

changes name of a special remote

## NAME

git-annex-renameremote - changes name of a special remote

## SYNOPSIS

git annex renameremote **name\|uuid\|desc newname**

## DESCRIPTION

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)](/git-annex-common-options/1.md) can be used.

  -

  ## SEE ALSO

[git-annex(1)](/git-annex/1.md)

[git-annex-initremote(1)](/git-annex-initremote/1.md)

[git-annex-enableremote(1)](/git-annex-enableremote/1.md)

[git-annex-configremote(1)](/git-annex-configremote/1.md)

## AUTHOR

Joey Hess \<id@joeyh.name\>