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

Version Platform License

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.

• 🔧 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

IMAGE ALT TEXT HERE

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.

• 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

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

# 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

• 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

• 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

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

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

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

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

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

# 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

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

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

• 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

• 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

We welcome contributions! Whether it's:

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

Get started by:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

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

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

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

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! 🚀