Build and Secure Your Own Onion Service
Onion services are not just for secrecy. News organizations, search engines, software projects and whistleblowing platforms publish their sites over Tor to resist censorship, give readers end-to-end authenticity without…
What this class covers
Onion services are not just for secrecy. News organizations, search engines, software projects and whistleblowing platforms publish their sites over Tor to resist censorship, give readers end-to-end authenticity without relying on certificate authorities, and keep reader metadata off the open internet. This advanced course shows developers and sysadmins how to do the same, correctly and responsibly.
You will build a Linux lab, install tor from the Tor Project's official repository, publish a static site through nginx bound to localhost, and learn exactly what the v3 keys, descriptors, introduction points and rendezvous circuits are doing. From there you harden everything: secure key backups, vanity prefixes, Onion-Location, HTTPS options, leak-free server configuration, client authorization, proof-of-work and rate-limit defenses, Onionbalance, log minimization and privacy-safe monitoring.
We also cover the responsibilities that come with operating a service: the law still applies, content and abuse need clear processes, and promises to readers must match your configuration. You finish with a reusable launch checklist for real deployments.
Lessons
17 lessons- 1 Why Legitimate Organizations Run Onion Services 5 min read
- 2 Onion Service Architecture Recap: Keys, Descriptors, and Rendezvous 5 min read
- 3 Lab Setup on Linux: VM, Official Packages, and torrc Basics 4 min read
- 4 Creating the Hidden Service Directory and HiddenServicePort 4 min read
- 5 Serving a Static Site with nginx Bound to Localhost 4 min read
- 6 Understanding and Backing Up Your Service Keys 5 min read
- 7 Vanity Prefixes: Concept, Compute Cost, and Tradeoffs 5 min read
- 8 Onion-Location: Advertising Your Onion from a Clearnet Site 4 min read
- 9 HTTPS on Onion Services: When It Helps and Your Options 5 min read
- 10 Hardening the Web Server Against Leaks and De-anonymization 5 min read
- 11 Client Authorization: Restricted Discovery for Private Services 5 min read
- 12 Availability and DoS Defenses: PoW, Rate Limits, and Onionbalance 5 min read
- 13 Logging and Privacy: Practicing Log Minimization 4 min read
- 14 Monitoring and Updates Without Compromising Privacy 5 min read
- 15 Legal and Ethical Responsibilities of Onion Service Operators 5 min read
- 16 Real-World Use Cases: SecureDrop, News Sites, and Search Engines 5 min read
- 17 Final Lesson: Your Onion Service Launch Checklist 5 min read
What you'll make
Deploy a hardened onion mirror of a small static website in a lab VM and document it as if handing it to a new operator.
- Publish the site via nginx on a Unix socket or localhost, with no public listeners.
- Create and test an encrypted backup and restore of the service keys.
- Apply security headers, remove external resources, and minimize logs.
- Enable PoW and intro-point DoS defenses, and add a private staff service using client authorization.
- Submit your completed launch checklist and a short operator policy.
Skills you'll build
More in DeepWeb
Start Ademy Pro today
Unlock this class and every other course on Ademy for $1.00. After that, it's $10.99/month.
Get started