Get started
For members
DeepWeb

Build and Secure Your Own Onion Service

By Ademy Team · 17 lessons · Advanced

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…

Get started Included in Ademy Pro · 7-day trial for $1.00

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. 1 Why Legitimate Organizations Run Onion Services 5 min read
  2. 2 Onion Service Architecture Recap: Keys, Descriptors, and Rendezvous 5 min read
  3. 3 Lab Setup on Linux: VM, Official Packages, and torrc Basics 4 min read
  4. 4 Creating the Hidden Service Directory and HiddenServicePort 4 min read
  5. 5 Serving a Static Site with nginx Bound to Localhost 4 min read
  6. 6 Understanding and Backing Up Your Service Keys 5 min read
  7. 7 Vanity Prefixes: Concept, Compute Cost, and Tradeoffs 5 min read
  8. 8 Onion-Location: Advertising Your Onion from a Clearnet Site 4 min read
  9. 9 HTTPS on Onion Services: When It Helps and Your Options 5 min read
  10. 10 Hardening the Web Server Against Leaks and De-anonymization 5 min read
  11. 11 Client Authorization: Restricted Discovery for Private Services 5 min read
  12. 12 Availability and DoS Defenses: PoW, Rate Limits, and Onionbalance 5 min read
  13. 13 Logging and Privacy: Practicing Log Minimization 4 min read
  14. 14 Monitoring and Updates Without Compromising Privacy 5 min read
  15. 15 Legal and Ethical Responsibilities of Onion Service Operators 5 min read
  16. 16 Real-World Use Cases: SecureDrop, News Sites, and Search Engines 5 min read
  17. 17 Final Lesson: Your Onion Service Launch Checklist 5 min read
Get started to unlock every lesson

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