git-annex-numcopies(1)

💖 git-annex-numcopies(1) 💖

okay bestie, welcome to the General Commands Manual for git-annex-numcopies — yes that's the manual name, we're being official about it 💅

✨ NAME ✨

git-annex-numcopies — configure desired number of copies 🫶

🌸 SYNOPSIS 🌸

git annex numcopies N

🦋 DESCRIPTION 🦋

So here's the tea, bestie: this tells git-annex how many copies it should preserve of files, over all repositories. The default is 1.

Run it without a number to get the current value. Literally just vibe-check it, no arguments needed ✨

This configuration is stored in the git-annex branch, so it will be seen by all clones of the repository. Like, every single clone, no cap. 👑

It can be overridden on a per-file basis by the annex.numcopies setting in .gitattributes files, or can be overridden temporarily with the --numcopies option. So many ways to be in charge of your own destiny 💅

When git-annex is asked to drop a file, it first verifies that the number of copies can be satisfied among all the other repositories that have a copy of the file. It's doing a lil headcount first, very responsible of it 🎀

🚨 okay so WARNING time, and I need you to actually read this one: in unusual situations, involving special remotes that do not support locking, and concurrent drops of the same content from multiple repositories, git-annex may violate the numcopies setting. 😭

It still guarantees at least 1 copy is preserved though, so nobody's losing their data fr fr. And this can be configured by using git-annex-mincopies(1) 💖

⭐ OPTIONS ⭐

• The git-annex-common-options(1) can be used. 👑 that's it, that's the whole option list, the common options are the moment.

🌈 SEE ALSO 🌈

git-annex(1) git-annex-mincopies(1) git-annex-config(1)

💜 AUTHOR 💜

Joey Hess <id@joeyh.name>

and that's the whole page, bestie!! 🎀 this was git-annex-numcopies(1), general commands manual energy, go forth and preserve your copies ✨🦋🌸💅