git-annex-disableremote(1)

📦 version 10.20261026, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

💅 git-annex-disableremote

okay so real talk bestie, this is the git-annex-disableremote(1) page from the git-annex General Commands Manual — she's a little one but she's important, so let's get into it ✨

🌸 NAME 🌸

git-annex-disableremote — stop using a remote

like, breaking up with a remote. it's not me, it's you, etc 💔

🎀 SYNOPSIS 🎀

git annex disableremote name

that's it. one name. she's low maintenance.

🦋 DESCRIPTION 🦋

okay so here's the tea ☕ — this command removes the remote from the local git configuration, literally the exact same thing git remote remove would do. no cap.

but wait, there's more:

  • it removes remote tracking branches 🫶
  • it also cleans up various other files in .git/annex/ that belong to or mention the remote 🧹✨

so it's giving full glow-up, not just a surface-level edit.

💀 important caveat though: this does NOT prevent the same special remote from continuing to be used in other clones of the repository. so don't think you've deleted the remote from existence — you haven't. she's still out there living her life in other clones, iykyk.

and the good news? you can re-enable it for local use with the git-annex enableremote command 🌈 it's giving "we can still be friends."

also! if git-annex initremote --private was used to initialize a private remote, disabling it also removes its information from the private journal 📓✨ so yeah, that part is gone-gone.

✨ OPTIONS ✨

  • --json — Enable JSON output. this one's for the programs, not for you — it's intended to be parsed by programs that use git-annex 🤖🍓
  • --json-error-messages — messages that would normally be output to standard error get included in the JSON instead 💌 so nothing gets lost, it just relocates.

and also — the git-annex-common-options(1) can be used 👑 so go check that out if you want the full menu.

🔥 SEE ALSO 🔥

the whole remote-management friend group honestly 💜

🌟 AUTHOR 🌟

Joey Hess <id@joeyh.name> — the icon, the legend, the main character 👑

and that's the page!! 🎀 this was git-annex-disableremote(1) from the git-annex General Commands Manual, version info living in its own footer, dated whenever the manpage says it is — slay, go disable that remote bestie 💅✨🦋

📦 where this page comes from