{"id":31660333,"url":"https://github.com/blackhatdevx/onionhoster","last_synced_at":"2025-10-07T17:06:00.038Z","repository":{"id":310367834,"uuid":"1039617413","full_name":"BlackHatDevX/onionhoster","owner":"BlackHatDevX","description":"The Ultimate Tor Hidden Service Hosting Tool - Deploy your web projects to the dark web in minutes!","archived":false,"fork":false,"pushed_at":"2025-08-27T10:05:19.000Z","size":29,"stargazers_count":11,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-27T19:39:35.100Z","etag":null,"topics":["bash","darkweb-onion-links","domain","onion-service","onionhoster"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/BlackHatDevX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-17T16:14:22.000Z","updated_at":"2025-08-27T10:05:22.000Z","dependencies_parsed_at":"2025-08-21T14:33:27.602Z","dependency_job_id":null,"html_url":"https://github.com/BlackHatDevX/onionhoster","commit_stats":null,"previous_names":["blackhatdevx/onionhoster"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/BlackHatDevX/onionhoster","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fonionhoster","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fonionhoster/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fonionhoster/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fonionhoster/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BlackHatDevX","download_url":"https://codeload.github.com/BlackHatDevX/onionhoster/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BlackHatDevX%2Fonionhoster/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278811851,"owners_count":26050183,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-07T02:00:06.786Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","darkweb-onion-links","domain","onion-service","onionhoster"],"created_at":"2025-10-07T17:05:57.917Z","updated_at":"2025-10-07T17:06:00.022Z","avatar_url":"https://github.com/BlackHatDevX.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdetails align=\"right\"\u003e\n\u003csummary\u003e🌐 Language\u003c/summary\u003e\n\n[English](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=en) | [简体中文](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=zh-CN) | [繁體中文](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=zh-TW) | [日本語](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=ja) | [한국어](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=ko) | [हिन्दी](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=hi) | [ไทย](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=th) | [Français](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=fr) | [Deutsch](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=de) | [Español](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=es) | [Italiano](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=it) | [Русский](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=ru) | [Português](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=pt) | [Nederlands](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=nl) | [Polski](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=pl) | [العربية](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=ar) | [فارسی](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=fa) | [Türkçe](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=tr) | [Tiếng Việt](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=vi) | [Bahasa Indonesia](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=id) | [অসমীয়া](https://openaitx.github.io/#/view?user=BlackHatDevX\u0026project=onionhoster\u0026lang=as)\n\n\u003c/details\u003e\n\n# OnionHoster v2.2\n\n\u003e **The Ultimate Tor Hidden Service Hosting Tool** - Deploy your web projects to the dark web in minutes!\n\u003e \n[![Version](https://img.shields.io/badge/version-2.2-brightgreen.svg)](https://github.com/BlackHatDevX/onionhoster)\n[![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20macOS-blue.svg)](https://github.com/BlackHatDevX/onionhoster)\n[![License](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/BlackHatDevX/onionhoster)\n\n\u003cimg width=\"1023\" height=\"551\" alt=\"ChatGPT Image Aug 27, 2025, 03_32_08 PM (1)-modified\" src=\"https://github.com/user-attachments/assets/92b6e834-2d4f-4cc7-8f77-82b9bafba8a5\" /\u003e\n\n\n---\n\n## 🚀 What is OnionHoster?\n\nOnionHoster 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.\n\n### ✨ Why Choose OnionHoster?\n\n- **🔧 Zero Configuration** - Works out of the box with any web project\n- **🌍 Cross-Platform** - Supports Linux, macOS, and major distributions\n- **⚡ One-Click Setup** - From zero to hidden service in under 2 minutes\n- **🔄 Auto-Updates** - Built-in update checker keeps you current\n- **💾 Backup \u0026 Restore** - Never lose your onion addresses\n- **🎯 Professional UI** - Beautiful colored interface with intuitive menus\n\n---\n## Preview\n\n[![IMAGE ALT TEXT HERE](https://github.com/user-attachments/assets/4b35dfb0-0059-4cc5-99c7-a5b9467a385d)](https://www.youtube.com/watch?v=oPvhA54Tp8w)\n\n\n# ⚠️ Warning: OnionHoster is NOT a magic anonymity tool — follow best practices or risk deanonymization\n\n**System Hardening**\n\n* Run the service inside a VM or container for isolation.\n* Keep the OS and packages updated.\n* Disable unnecessary services/ports so only Tor traffic goes in/out.\n\n**OpSec Practices**\n\n* Don’t use the same machine for personal accounts or activities.\n* Avoid exposing identifying metadata (filenames, headers, error messages).\n* Be mindful of logs — what you log, how long you keep them, and whether they leak info.\n\n**Network Hygiene**\n\n* Don’t bridge your hidden service with your clearnet identity or domain.\n* Use a firewall to ensure no accidental leaks outside Tor.\n* Consider reverse proxies for extra isolation.\n\n**Testing \u0026 Monitoring**\n\n* Use torsocks or the Tor Browser to verify that your service is only reachable via its `.onion` address.\n* Test regularly for leaks (e.g., whether your app is trying to fetch from the clearnet).\n\n**Use Case Awareness**\n\n* For hobby/testing/educational use: the above is usually sufficient.\n* 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.\n\n\n---\n## 🎯 Perfect For\n\n- **Developers** who want to test their apps on Tor\n- **Privacy Advocates** hosting anonymous services (\n- **Researchers** studying dark web technologies\n- **Businesses** requiring anonymous hosting solutions\n- **Hobbyists** exploring the Tor network\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n- Root/sudo access\n- Internet connection\n- Any web project (HTML, Next.js, Flask, etc.)\n\n### Installation \u0026 Usage\n\n```bash\n# 1. Clone the repository\ngit clone https://github.com/BlackHatDevX/onionhoster.git\n\n# 2. Navigate to the directory\ncd onionhoster\n\n# 3. Make the script executable\nchmod +x onionhoster.sh\n\n# 4. Run with sudo\nsudo bash onionhoster.sh\n```\n\n**That's it!** 🎉\n\nYou'll get the complete OnionHoster project including:\n- The main `onionhoster.sh` script\n- A professional `index.html` template to host\n- All documentation and examples\n\nThe script will automatically:\n- Detect your operating system\n- Install all required dependencies (Tor, Apache, etc.)\n- Configure Tor services\n- Present you with an intuitive menu\n\n---\n\n## 🎮 Features Overview\n\n### 🌐 Hosting Options\n- **Static HTML** - Host any `index.html` file\n- **Port Forwarding** - Forward to any local application port\n- **Dynamic Apps** - Support for Next.js, Flask, Node.js, and more\n\n### 🛠️ Management Tools\n- **Service Control** - Start, stop, and manage your hidden service\n- **Backup \u0026 Restore** - Safely backup and restore your onion domains\n- **URL Refresh** - Generate new onion addresses when needed\n- **Status Monitoring** - Check service health and status\n\n### 🔄 Smart Updates\n- **Auto-Detection** - Automatically finds the latest version\n- **One-Click Updates** - Update with a single menu option\n- **Safe Updates** - No risk of losing your configuration\n\n---\n\n## 📱 Supported Operating Systems\n\n| OS | Package Manager | Status |\n|----|----------------|---------|\n| **Ubuntu/Debian** | `apt-get` | ✅ Full Support |\n| **CentOS/RHEL** | `yum` | ✅ Full Support |\n| **Fedora** | `dnf` | ✅ Full Support |\n| **Arch Linux** | `pacman` | ✅ Full Support |\n| **macOS** | `brew` | ✅ Full Support |\n\n---\n\n## 🎯 Use Cases\n\n### 🏠 Personal Projects\n- Host your portfolio anonymously\n- Test web applications privately\n- Share content without revealing your identity\n\n### 🏢 Business Applications\n- Anonymous customer support portals\n- Secure internal communication systems\n- Privacy-focused business websites\n\n### 🔬 Research \u0026 Development\n- Dark web technology research\n- Privacy tool development\n- Anonymous service testing\n\n---\n\n## 📖 Detailed Usage\n\n### Main Menu Options\n\n1. **Host index.html** - Serve a static HTML file\n2. **Forward to Application Port** - Proxy to any local service\n3. **Backup tor domain** - Save your onion configuration\n4. **Restore tor domain** - Restore from backup\n5. **View current tor domain** - See your active onion address\n6. **Refresh tor domain** - Generate a new onion address\n7. **Check for updates** - Update to the latest version\n8. **Web Server Status** - Monitor service health\n9. **About OnionHoster** - Version and feature information\n\n### Example Workflow\n\n```bash\n# Start the service\nsudo ./onionhoster.sh\n\n# Choose option 1 to host index.html\n# Your onion address will be displayed\n# Access it via Tor Browser or similar\n```\n\n---\n\n## 🔧 Advanced Configuration\n\n### Custom Port Forwarding\n```bash\n# Forward your Next.js app running on port 3000\n# The script will handle all Tor configuration automatically\n```\n\n### Backup Management\n```bash\n# Automatic backups are stored in ~/onion_backups/\n# Each backup includes your onion keys and configuration\n```\n\n---\n\n## 🛡️ Security Features\n\n- **Automatic Tor Configuration** - Secure defaults out of the box\n- **Proper File Permissions** - Secure file ownership and access\n- **Service Isolation** - Each hidden service runs independently\n- **No Data Logging** - Your activities remain private\n\n---\n\n## 🚨 Important Notes\n\n- **Root Access Required** - Tor services need system-level configuration\n- **Tor Network** - Your service will be accessible via Tor Browser\n- **Onion Addresses** - Each service gets a unique `.onion` address\n- **Backup Regularly** - Onion addresses change when refreshing\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Whether it's:\n- 🐛 Bug reports\n- 💡 Feature requests\n- 📝 Documentation improvements\n- 🔧 Code contributions\n\n**Get started by:**\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Submit a pull request\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- **Tor Project** - For the amazing anonymity network\n- **Open Source Community** - For continuous improvements\n- **Users \u0026 Contributors** - For feedback and suggestions\n\n---\n\n## 🔗 Links\n\n- **GitHub**: [https://github.com/BlackHatDevX/onionhoster](https://github.com/BlackHatDevX/onionhoster)\n- **Issues**: [https://github.com/BlackHatDevX/onionhoster/issues](https://github.com/BlackHatDevX/onionhoster/issues)\n- **Discussions**: [https://github.com/BlackHatDevX/onionhoster/discussions](https://github.com/BlackHatDevX/onionhoster/discussions)\n\n---\n\n## ⭐ Star This Project\n\nIf OnionHoster helps you, please give it a star! It motivates us to keep improving and helps others discover this tool.\n\n---\n\n**Ready to go anonymous?** 🕵️‍♂️\n\n```bash\ngit clone https://github.com/BlackHatDevX/onionhoster.git\ncd onionhoster\nsudo bash onionhoster.sh\n```\n\n*Your journey to anonymous hosting starts now!* 🚀\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackhatdevx%2Fonionhoster","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackhatdevx%2Fonionhoster","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackhatdevx%2Fonionhoster/lists"}