Pimeleon Architecture

Learn how Pimeleon router works, what services protect your network, and how everything fits together.


Pimeleon Architecture

Learn how Pimeleon router works, what services protect your network, and how everything fits together.

Network Architecture

Understand the network design and layout:

Core Services

Essential services that make Pimeleon router work:

Filtering & Privacy

Services that protect your privacy and block unwanted content:

How It All Works Together

Pimeleon router uses a defense-in-depth approach with multiple protection layers:

Internet
    ↓
[Firewall] ← Blocks unwanted connections
    ↓
[DNS Filtering] ← Blocks ads/trackers at DNS level
    ↓
[DNSCrypt] ← Encrypts DNS queries
    ↓
[HTTP Proxy] ← Additional content filtering
    ↓
[Tor] ← Optional anonymity layer
    ↓
Your Devices

Layer 1: Firewall

  • First line of defense
  • Blocks unauthorized access
  • Controls traffic between zones
  • See: Firewall Protection

Layer 2: DNS Filtering

  • Blocks ads and trackers at domain level
  • Prevents malware C&C connections
  • Protects all devices automatically
  • See: DNS Filtering

Layer 3: DNS Encryption

  • Prevents DNS snooping by ISP
  • Protects DNS privacy
  • Validates DNS responses (DNSSEC)
  • See: DNSCrypt Privacy

Layer 4: HTTP Filtering

Layer 5: Anonymity (Optional)

  • Routes traffic through Tor network
  • Hides your real IP address
  • Access .onion sites
  • See: Tor Anonymity

Performance Characteristics

Understanding what to expect:

ServiceLatency ImpactCPU UsageRAM Usage
Firewall< 1ms< 5%~50MB
DNS Filtering~5-10ms< 10%~150MB
DNSCrypt~10-30ms< 5%~20MB
HTTP Proxy~5-15ms5-15%~100MB
Tor500-2000ms10-20%~100MB

Total typical overhead:

  • Latency: ~20-50ms (without Tor)
  • CPU: 20-35% average
  • RAM: ~420MB
  • Bandwidth: No reduction

Design Principles

Pimeleon router architecture is built on:

  1. Defense in Depth - Multiple protection layers
  2. Privacy by Default - All filtering enabled out of the box
  3. Transparency - Know what's happening on your network
  4. User Control - Easy to customize and configure
  5. Performance - Minimal impact on network speed

For Developers

If you're building on Pimeleon router:


← Previous: Getting Started | 🏠 Documentation Home | Next: Deployment →