TORSOCKS(1)

💅 TORSOCKS — the torify glow-up wrapper

okay bestie, welcome to torsocks, from section 1 of the manual 🎀 it's a shell wrapper that makes using the torsocks(8) library way easier, so you can transparently torify basically any application. yes queen, transparently. like it's not even trying. ✨

---

🌸 SYNOPSIS 🌸

torsocks [OPTIONS] [COMMAND [ARG ...]]

---

🦋 DESCRIPTION 🦋

So here's the tea: torsocks is the lil' middleman (a wrapper) hanging out between the torsocks library and your application, and its whole job is making every single Internet communication go through the Tor network. no cap. every one. 🫶

By default, torsocks assumes it should connect to the Tor SOCKS proxy chillin' at 127.0.0.1 on port 9050 — those are the defaults of the Tor daemon, so honestly it just knows. 💅

Wanna use a config file? It tries to read /etc/tor/torsocks.conf first, or it'll go looking for the environment variable TORSOCKS_CONF_FILE holding the location of the file. And if that file simply cannot be read? It does not panic, bestie, it just falls back on sensible defaults that work for most Tor installations. iconique behaviour tbh. ✨

for even more deets on configuration, go read torsocks.conf(5). iykyk 📖

---

✨ OPTIONS ✨

• -h, --help — shows you a lil' summary of all the possible options and commands. your friendly map 🗺️
• --shell — creates a brand new shell with LD_PRELOAD including torsocks(8). new shell, who dis 🐚
• --version — shows the version. flex the build 💅
• -u, --user — sets the username for the SOCKS5 authentication. use it for circuit isolation in Tor. ⚠️ and note that you MUST have a password set, either by the command line, environment variable or configuration file (torsocks.conf(5)). no password, no party.
• -p, --pass — sets the password for the SOCKS5 authentication. use it for circuit isolation in Tor. ⚠️ and note that you MUST have a username set, either by the command line, environment variable or configuration file (torsocks.conf(5)). they're a package deal fr fr.
• -a, --address — sets the Tor address. accepts only numeric addresses, so don't be trying to be cute with hostnames here.
• -P, --port — sets the Tor port. 🔌
• -i, --isolate — automatic tor isolation 🧚 it sets the username and password for the SOCKS5 authentication method to a PID/current time based value, automatically, like magic. ⚠️ but listen: Username and Password MUST NOT be set. do not mix, bestie.
• -6, --ipv6 — enables the creation of ipv6 sockets. six-y and thriving 🌈
• -d, --debug — activates debug mode. output gets written on stderr. loud and proud 📢
• -q, --quiet — suppresses every log message. even the errors. absolute silence. 🤫
• on | off — this option adds or removes torsocks(8) from the LD_PRELOAD environment variable for the current shell. ⚠️ if you wanna use this one, you HAVE to source torsocks from your shell. no sourcing, no switching.

Add the torsocks library to LD_PRELOAD

$ . torsocks on

Remove the torsocks library from LD_PRELOAD

$ . torsocks off

• show | sh — shows the current value of the LD_PRELOAD environment variable. vibe check on your env 👀

---

🌈 ENVIRONMENT VARIABLES 🌈

pls go see torsocks(8) for way more detail on all the possible environment variables, that's where the full lore lives 📚

---

💖 SEE ALSO 💖

• torsocks(8)
• torsocks.conf(5)

---

👑 CREDITS 👑

torsocks is distributed under the GNU General Public License version 2. slay, legally 🎀

There's a Web site at https://www.torproject.org if you want more information. 🌐

You can also find the source code at https://git.torproject.org. go look, it's giving open source 💅

Mailing list for help is <tor-talk@lists.torproject.org> and for development use <tor-dev@lists.torproject.org>. You can find the project also on IRC server irc.oftc.net (OFTC) in #tor and #tor-dev. come hang out, the group chat is literally right there 🫶

---

⭐ AUTHOR ⭐

torsocks was originally written by Robert Hogan and has been rewritten by David Goulet <dgoulet@torproject.org> in 2013. two icons, one legacy 💖

---

and that's the whole page, bestie! this one's dated March 3rd, 2014, and it's TORSOCKS(1) — go torify something cute. mwah 💋✨