🌐 Language

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | हिन्दी | ไทย | Français | Deutsch | Español | Italiano | Русский | Português | Nederlands | Polski | العربية | فارسی | Türkçe | Tiếng Việt | Bahasa Indonesia | অসমীয়া

OnionHoster v2.2

The Ultimate Tor Hidden Service Hosting Tool - Deploy your web projects to the dark web in minutes!

---

🚀 What is OnionHoster?

OnionHoster is a powerful, cross-platform bash script that transforms any web project into a Tor hidden service with just one command. Whether you're hosting a Next.js app, Flask backend, or static website, OnionHoster handles all the complex Tor configuration automatically.

✨ Why Choose OnionHoster?

• 🔧 Zero Configuration - Works out of the box with any web project
• 🌍 Cross-Platform - Supports Linux, macOS, and major distributions
• ⚡ One-Click Setup - From zero to hidden service in under 2 minutes
• 🔄 Auto-Updates - Built-in update checker keeps you current
• 💾 Backup & Restore - Never lose your onion addresses
• 🎯 Professional UI - Beautiful colored interface with intuitive menus

---

Preview

⚠️ Warning: OnionHoster is NOT a magic anonymity tool — follow best practices or risk deanonymization

System Hardening

• Run the service inside a VM or container for isolation.
• Keep the OS and packages updated.
• Disable unnecessary services/ports so only Tor traffic goes in/out.

OpSec Practices

• Don’t use the same machine for personal accounts or activities.
• Avoid exposing identifying metadata (filenames, headers, error messages).
• Be mindful of logs — what you log, how long you keep them, and whether they leak info.

Network Hygiene

• Don’t bridge your hidden service with your clearnet identity or domain.
• Use a firewall to ensure no accidental leaks outside Tor.
• Consider reverse proxies for extra isolation.

Testing & Monitoring

• Use torsocks or the Tor Browser to verify that your service is only reachable via its .onion address.
• Test regularly for leaks (e.g., whether your app is trying to fetch from the clearnet).

Use Case Awareness

• For hobby/testing/educational use: the above is usually sufficient.
• For high-risk, real-world anonymity (journalists, whistleblowers, activists): it requires deeper operational security and threat modeling, since a single misstep can de-anonymize you.

---

🎯 Perfect For

• Developers who want to test their apps on Tor
• Privacy Advocates hosting anonymous services (
• Researchers studying dark web technologies
• Businesses requiring anonymous hosting solutions
• Hobbyists exploring the Tor network

---

🚀 Quick Start

Prerequisites

• Root/sudo access
• Internet connection
• Any web project (HTML, Next.js, Flask, etc.)

Installation & Usage

# 1. Clone the repository
git clone https://github.com/BlackHatDevX/onionhoster.git
2. Navigate to the directory
cd onionhoster
3. Make the script executable
chmod +x onionhoster.sh
4. Run with sudo
sudo bash onionhoster.sh

That's it! 🎉

You'll get the complete OnionHoster project including:

• The main onionhoster.sh script
• A professional index.html template to host
• All documentation and examples

The script will automatically:

• Detect your operating system
• Install all required dependencies (Tor, Apache, etc.)
• Configure Tor services
• Present you with an intuitive menu

---

🎮 Features Overview

🌐 Hosting Options

• Static HTML - Host any index.html file
• Port Forwarding - Forward to any local application port
• Dynamic Apps - Support for Next.js, Flask, Node.js, and more

🛠️ Management Tools

• Service Control - Start, stop, and manage your hidden service
• Backup & Restore - Safely backup and restore your onion domains
• URL Refresh - Generate new onion addresses when needed
• Status Monitoring - Check service health and status

🔄 Smart Updates

• Auto-Detection - Automatically finds the latest version
• One-Click Updates - Update with a single menu option
• Safe Updates - No risk of losing your configuration

---

📱 Supported Operating Systems

| OS | Package Manager | Status | |----|----------------|---------| | Ubuntu/Debian | apt-get | ✅ Full Support | | CentOS/RHEL | yum | ✅ Full Support | | Fedora | dnf | ✅ Full Support | | Arch Linux | pacman | ✅ Full Support | | macOS | brew | ✅ Full Support |

---

🎯 Use Cases

🏠 Personal Projects

• Host your portfolio anonymously
• Test web applications privately
• Share content without revealing your identity

🏢 Business Applications

• Anonymous customer support portals
• Secure internal communication systems
• Privacy-focused business websites

🔬 Research & Development

• Dark web technology research
• Privacy tool development
• Anonymous service testing

---

📖 Detailed Usage

Main Menu Options

• Host index.html - Serve a static HTML file
• Forward to Application Port - Proxy to any local service
• Backup tor domain - Save your onion configuration
• Restore tor domain - Restore from backup
• View current tor domain - See your active onion address
• Refresh tor domain - Generate a new onion address
• Check for updates - Update to the latest version
• Web Server Status - Monitor service health
• About OnionHoster - Version and feature information

Example Workflow

# Start the service
sudo ./onionhoster.sh
Choose option 1 to host index.html
Your onion address will be displayed
Access it via Tor Browser or similar

---

🔧 Advanced Configuration

Custom Port Forwarding

# Forward your Next.js app running on port 3000
The script will handle all Tor configuration automatically

Backup Management

# Automatic backups are stored in ~/onion_backups/
Each backup includes your onion keys and configuration

---

🛡️ Security Features

• Automatic Tor Configuration - Secure defaults out of the box
• Proper File Permissions - Secure file ownership and access
• Service Isolation - Each hidden service runs independently
• No Data Logging - Your activities remain private

---

🚨 Important Notes

• Root Access Required - Tor services need system-level configuration
• Tor Network - Your service will be accessible via Tor Browser
• Onion Addresses - Each service gets a unique .onion address
• Backup Regularly - Onion addresses change when refreshing

---

🤝 Contributing

We welcome contributions! Whether it's:

• 🐛 Bug reports
• 💡 Feature requests
• 📝 Documentation improvements
• 🔧 Code contributions

Get started by:

• Fork the repository
• Create a feature branch
• Make your changes
• Submit a pull request

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• Tor Project - For the amazing anonymity network
• Open Source Community - For continuous improvements
• Users & Contributors - For feedback and suggestions

---

🔗 Links

• GitHub: https://github.com/BlackHatDevX/onionhoster
• Issues: https://github.com/BlackHatDevX/onionhoster/issues
• Discussions: https://github.com/BlackHatDevX/onionhoster/discussions

---

⭐ Star This Project

If OnionHoster helps you, please give it a star! It motivates us to keep improving and helps others discover this tool.

---

Ready to go anonymous? 🕵️‍♂️

git clone https://github.com/BlackHatDevX/onionhoster.git
cd onionhoster
sudo bash onionhoster.sh

Your journey to anonymous hosting starts now! 🚀

--- Tranlated By Open Ai Tx | Last indexed: 2025-08-28 ---