torfolder

Easily create a .onion server via Tor from any local folder. This CLI tool turns the directory where it runs into a globally accessible website over the Tor network.

---

📦 Requirements

• Go installed
• Tor installed
• The tor executable must be available in your system's terminal (PATH environment variable)

💡 How to make sure tor is in your PATH

Windows

1. Download and install the Tor Expert Bundle
2. Extract the files (e.g. to C:\Tor)
3. Add the folder containing tor.exe to your system PATH:
   • Control Panel → System → Advanced Settings → Environment Variables
   • Edit the Path variable and add: C:\Tor
4. Restart your terminal
5. Test it:

   tor --version

Linux/macOS

Install via your package manager:

sudo apt install tor       # Debian/Ubuntu
brew install tor           # macOS (Homebrew)

Then test:

tor --version

---

🚀 How to use

1. Place the compiled torfolder binary in a directory that is in your system's PATH
2. Navigate to the folder you want to expose in your terminal
3. Run the command:

torfolder

The terminal will display something like:

🚀 Your site is available on the Tor network:
    http://abc123xyz.onion

4. Open the URL in the Tor Browser or a Brave browser session using Tor
5. A new .onion link is generated each time, unless you preserve the data folder

---

⚠️ Security

• The tor-data/ folder and any data-dir-* folders are automatically protected and not served over HTTP
• The embedded Tor process runs silently by default
• The .onion private key is stored temporarily (unless you manually preserve the generated folder)

---

Made with 💻 using Go + Tor + Bine