git-annex-enable-tor(1)

✨ git-annex-enable-tor ✨

bestie. you are about to turn your repo into a whole secret little tor hidden service and honestly? iconic behavior. this is page one of the git-annex manual, section one, general commands manual, and we are gonna get you SET UP 💅

---

🌸 NAME 🌸

git-annex-enable-tor — enable tor hidden service 🧅✨

---

🎀 SYNOPSIS 🎀

git annex enable-tor

sudo git annex enable-tor $(id -u)

---

🦋 DESCRIPTION 🦋

okay so, this command enables a tor hidden service for git-annex. lowkey magical, highkey useful 🫶

here's the tea: it goes in and modifies /etc/tor/torrc to register the hidden service. that's the file. that's the one it touches. no cap.

if you run it as a normal user, it will try to use sudo/su/etc to get root access so it can modify that file. it's giving "i'll ask politely for the keys" 😭

if you run it as root, then you gotta pass it your non-root user id number, as output by id -u. like, the command needs to know which human this hidden service is actually for. so:

sudo git annex enable-tor $(id -u)

the way that $(id -u) just hands over your uid in the middle of a sudo call... chef's kiss 👑

ngl, if you're root and you don't pass the user id, you're gonna have a bad time. the user id is the whole point of that second synopsis line, fr fr.

after this command is run, git annex remotedaemon can be run to serve the tor hidden service. and then git-annex p2p --pair or git-annex p2p --gen-addresses can be run to give other users access to your repository via the tor hidden service. that's the full pipeline: enable it, serve it, invite your friends in 🥳

---

💖 OPTIONS 💖

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

that's it. that's the options section. sometimes less is more, bestie ✨

---

🌈 SEE ALSO 🌈

• git-annex(1)
• git-annex-p2p(1)
• git-annex-remotedaemon(1)

---

👑 AUTHOR 👑

Joey Hess <id@joeyh.name>

---

and that's the whole page, babe 🩷 this came to you straight out of the git-annex-enable-tor(1) manual — the general commands manual, section 1 — and it's a certified banger. go forth, enable your hidden service, and slay. periodt 💅🎀🦋