🧅 Tor Guard Relay

A hardened, production-ready Tor relay with built-in diagnostics and monitoring

Quick Start • Features • Documentation • FAQ • Architecture • Tools • Contributing

▍ 🚀 What is This?

Tor Guard Relay is a production-ready, self-healing Tor relay container designed for privacy advocates who want to contribute to the Tor network securely and efficiently.

🌉 Multi-Mode: guard, exit, and bridge with obfs4 transport. Configure via TOR_RELAY_MODE.

Why Choose This Project?

🛡️ Security-First - Hardened Alpine Linux, non-root operation
🪶 Very light - Ultra-minimal 16.8 MB image
🎯 Simple - One command to deploy, minimal configuration needed
📊 Observable - 5 busybox-only diagnostic tools with JSON health API
🌉 Multi-Mode - Supports guard, exit, and bridge (obfs4) relays
🔄 Automated - Weekly security rebuilds, CI/CD ready
📚 Documented - Comprehensive guides for deployment, monitoring, backup, and more
🏗️ Multi-Arch - Native support for AMD64 and ARM64 (Raspberry Pi, AWS Graviton, etc.)

▍ 🔒 Security Model

Port Exposure Policy

9001 ORPort, public
9030 DirPort, public for guard and exit
9002 obfs4 for bridge mode

Environment Variables

TOR_ORPORT default 9001
TOR_DIRPORT default 9030
TOR_OBFS4_PORT default 9002

Diagnostics are run only through docker exec, with no exposed monitoring ports.

Minimal surface area, roughly 16.8 MB.

▍ ⚡ Quick Start

System Requirements

Component	Minimum	Recommended
CPU	1 core	2+ cores
RAM	512 MB	1 GB+
Disk	10 GB	20 GB+ SSD
Bandwidth	10 Mbps	100+ Mbps
Uptime	95 percent	99 percent
Docker	20.10+	Latest

Supported Architectures: AMD64, ARM64

Network Security Notes

⚠️ Port Exposure:

Guard/Middle/Exit: Ports 9001 (ORPort) and 9030 (DirPort) should be publicly accessible
Bridge: Ports 9001 (ORPort) and 9002 (obfs4) should be publicly accessible
No monitoring ports - all diagnostics via docker exec commands only
Use --network host for best IPv6 support (Tor recommended practice)

Interactive Quick Start (Recommended for Beginners)

🚀 Try our interactive setup script:

# Download and run the quick-start script
curl -fsSL https://raw.githubusercontent.com/r3bo0tbx1/tor-guard-relay/main/scripts/quick-start.sh -o quick-start.sh
chmod +x quick-start.sh
sh ./quick-start.sh

The script will:

✅ Guide you through relay type selection (guard, exit, bridge)
✅ Collect required information with validation
✅ Generate deployment commands or docker-compose.yml
✅ Provide next steps and monitoring guidance

Manual Deployment

Step 1: Create your relay configuration (or use our example):

mkdir -p ~/tor-relay && cd ~/tor-relay
curl -o relay.conf https://raw.githubusercontent.com/r3bo0tbx1/tor-guard-relay/refs/heads/main/examples/relay-guard.conf
nano relay.conf

Step 2: Run (Docker Hub)

docker run -d \
  --name tor-relay \
  --restart unless-stopped \
  --network host \
  --security-opt no-new-privileges:true \
  -v $(pwd)/relay.conf:/etc/tor/torrc:ro \
  -v tor-guard-data:/var/lib/tor \
  -v tor-guard-logs:/var/log/tor \
  r3bo0tbx1/onion-relay:latest

Step 3: Verify it's running:

# Check status
docker exec tor-relay status

# View fingerprint
docker exec tor-relay fingerprint

# Stream logs
docker logs -f tor-relay

That's it! Your relay will bootstrap in 10-30 minutes and appear on Tor Metrics within 1-2 hours.

📖 Need more? See our comprehensive Deployment Guide for Docker Compose, Cosmos Cloud, Portainer, and advanced setups.

▍ 🎯 Choosing a Variant

We offer two build variants to match your risk tolerance and requirements:

Stable Variant (Recommended)

Base: Alpine 3.23.0 | Recommended for: Production relays

✅ Battle-tested Alpine stable release
✅ Weekly automated rebuilds with latest security patches
✅ Proven stability for long-running relays
✅ Available on both Docker Hub and GHCR

# Pull from Docker Hub (easiest)
docker pull r3bo0tbx1/onion-relay:latest
docker pull r3bo0tbx1/onion-relay:1.1.3

# Pull from GHCR
docker pull ghcr.io/r3bo0tbx1/onion-relay:latest
docker pull ghcr.io/r3bo0tbx1/onion-relay:1.1.3

Edge Variant (Testing Only)

Base: Alpine edge | Recommended for: Testing, security research

⚡ Bleeding-edge Alpine packages (faster security updates)
⚡ Latest Tor and obfs4 versions as soon as available
⚡ More frequent rebuilds - Every 3 days + weekly (~2-3x faster updates than stable)
⚠️ NOT recommended for production - less stable, potential breaking changes
📦 Available on both Docker Hub and GHCR

# Pull from Docker Hub
docker pull r3bo0tbx1/onion-relay:edge

# Pull from GHCR
docker pull ghcr.io/r3bo0tbx1/onion-relay:edge
docker pull ghcr.io/r3bo0tbx1/onion-relay:1.1.3-edge

When to use edge:

🔬 Testing new Tor features before stable release
🛡️ Security research requiring latest packages
🧪 Non-production test environments
🚀 Early adopters willing to accept potential breakage

Stability comparison:

Feature	Stable	Edge
Production ready	✅ Yes	❌ No
Breaking changes	❌ Rare	⚠️ Possible
Security updates	Weekly	Weekly (newer packages)
Package versions	Proven	Bleeding edge
Docker Hub	✅ Yes	✅ Yes
GHCR	✅ Yes	✅ Yes

💡 Our recommendation: Use stable for production relays, edge only for testing or when you specifically need the latest package versions.

▍ 🏗️ Deployment Methods

Choose the method that fits your workflow.

Method	Best For	Guide
🐳 Docker CLI	Quick testing	Guide
📦 Docker Compose	Production	Guide
☁️ Cosmos Cloud	UI based deployment	Guide
🎛️ Portainer	Web UI	Guide

New to Docker? Try Cosmos Cloud by azukaar - a gorgeous, self-hosted Docker management platform.

Multi-Relay Setup

Running multiple relays? We have templates for that:

Docker Compose: docker-compose-multi-relay.yml - 3 relays setup
Cosmos Cloud: cosmos-compose-multi-relay.json - Multi-relay stack

See Deployment Guide for complete instructions.

▍ 🔧 Diagnostic Tools

Version >=v1.1.1 includes five busybox-only tools.

Tool	Purpose	Usage
status	Full health report	`docker exec tor-relay status`
health	JSON health	`docker exec tor-relay health`
fingerprint	Show fingerprint	`docker exec tor-relay fingerprint`
bridge-line	obfs4 line	`docker exec tor-relay bridge-line`
gen-auth	Credentials for Nyx	`docker exec tor-relay gen-auth`

# Full health report with emojis
docker exec tor-relay status

# JSON output for automation/monitoring
docker exec tor-relay health

Example JSON:

{
  "status": "healthy",
  "bootstrap": 100,
  "reachable": true,
  "fingerprint": "1234567890ABCDEF",
  "nickname": "MyRelay",
  "uptime_seconds": 3600
}

📖 Complete reference: See Tools Documentation for all 5 tools with examples, JSON schema, and integration guides.

▍ 📊 Monitoring and Observability

>=v1.1.2 supports both real-time CLI monitoring and external observability for minimal image size and maximum security.

Real-Time Monitoring (Nyx)

You can connect Nyx (formerly arm) to your relay securely using the Control Port.

Generate credentials: docker exec tor-relay gen-auth
Add the hash to your config.
Connect via local socket or TCP.

📖 Full Setup: See the Control Port Guide for step-by-step Nyx configuration.

JSON Health API

The health tool provides JSON output for monitoring integration:

# Get health status (raw JSON)
docker exec tor-relay health

# Parse with jq (requires jq installed on HOST machine)
docker exec tor-relay health | jq .

# Example cron-based monitoring
*/5 * * * * docker exec tor-relay health | jq '.status' | grep -q 'healthy' || alert

Note: jq must be installed on your HOST machine (apt install jq / brew install jq), NOT in the container.

Integration Examples

Prometheus Node Exporter:

# Use textfile collector (requires jq on host)
docker exec tor-relay health | jq -r '
  "tor_bootstrap_percent \(.bootstrap)",
  "tor_reachable \(if .reachable then 1 else 0 end)"
' > /var/lib/node_exporter/tor.prom

Nagios/Icinga:

#!/bin/bash
# Requires jq on host machine
HEALTH=$(docker exec tor-relay health)
STATUS=$(echo "$HEALTH" | jq -r '.status')
[ "$STATUS" = "healthy" ] && exit 0 || exit 2

📖 Complete guide: See Monitoring Documentation for Prometheus, Grafana, alert integration, and observability setup.

▍ 🎯 Key Features

Security & Reliability

✅ Non-root execution (runs as tor user)
✅ Ultra-minimal Alpine Linux base (~16.8 MB)
✅ Busybox-only tools (no bash/python dependencies)
✅ Automatic permission healing on startup
✅ Configuration validation before start
✅ Tini init for proper signal handling
✅ Graceful shutdown with cleanup

Operations & Automation

✅ 5 busybox-only diagnostic tools (status, health, fingerprint, bridge-line, gen-auth)
✅ JSON health API for monitoring integration
✅ Multi-mode support (guard, exit, bridge with obfs4)
✅ ENV-based config (TOR_RELAY_MODE, TOR_NICKNAME, etc.)
✅ Multi-architecture builds (AMD64, ARM64)
✅ Weekly security rebuilds via GitHub Actions
✅ Docker Compose templates for single/multi-relay
✅ Cosmos Cloud support with one-click deploy

Developer Experience

✅ Comprehensive documentation (8 guides)
✅ Example configurations included
✅ GitHub issue templates
✅ Automated dependency updates (Dependabot)
✅ CI/CD validation and testing
✅ Multi-arch support (same command, any platform)

▍ 🖼️ Gallery

Cosmos Cloud Dashboard	Docker Logs (Bootstrapping)

Relay Status Tool	Obfs4 Bridge Line

▍ 📚 Documentation

>=v1.1.1 includes comprehensive documentation organized by topic:

Getting Started

FAQ - ⭐ NEW! Frequently asked questions with factual answers
Quick Start Script - ⭐ NEW! Interactive relay deployment wizard
Migration Assistant - ⭐ NEW! Automated migration from thetorproject/obfs4-bridge
Deployment Guide - ✨ UPDATED! Complete installation for Docker CLI, Compose, Cosmos Cloud, and Portainer
Migration Guide - Upgrade to >=v1.1.1 or migrate from other Tor setups

Technical Reference

Architecture - ⭐ NEW! Technical architecture with Mermaid diagrams
Tools Reference - ✨ UPDATED! Complete guide to all 5 diagnostic tools
Monitoring Guide - ✨ UPDATED! External monitoring integration, JSON health API, alerts, and observability
Control Port Guide - ⭐ NEW! Authentication setup and Nyx integration
Backup Guide - Data persistence, recovery, and disaster planning
Performance Guide - Optimization, tuning, and resource management

Legal & Community

Legal Considerations - ✨ UPDATED! Legal aspects of running a Tor relay
Documentation Index - Complete documentation navigation

Project Info

Security Policy - Security practices and vulnerability reporting
Contributing Guide - How to contribute to the project
Code of Conduct - Community guidelines
Changelog - Version history and changes

💡 Tip: Start with the FAQ for quick answers or Documentation Index for complete navigation.

▍ 🛠️ Configuration

Minimal Configuration

Nickname MyTorRelay
ContactInfo your-email@example.com
ORPort 9001
ORPort [::]:9001
DirPort 9030
ExitRelay 0
SocksPort 0
DataDirectory /var/lib/tor
Log notice file /var/log/tor/notices.log

Production Configuration

RelayBandwidthRate 50 MBytes
RelayBandwidthBurst 100 MBytes
NumCPUs 2
MaxMemInQueues 512 MB
ORPort [::]:9001

Example Configurations

Examples are found in the examples/ directory for complete, annotated configuration files:

relay-guard.conf - Recommended production config
Additional examples for specific use cases

📖 Configuration help: See Deployment Guide for complete reference.

▍ 🔍 Monitoring Your Relay

Check Bootstrap Status

# Quick status
docker exec tor-relay status

# JSON output for automation (raw)
docker exec tor-relay health

# Parse specific field with jq (requires jq on host)
docker exec tor-relay health | jq .bootstrap
```r exec tor-relay health | jq .bootstrap

View on Tor Metrics

After 1-2 hours, find your relay:

🔗 Tor Metrics Relay Search

Search by:

Nickname (e.g., "MyTorRelay")
Fingerprint (get with docker exec tor-relay fingerprint)
IP address

Expected Timeline

Milestone	Time	What to Expect
Bootstrap Complete	10-30 min	Logs show "Bootstrapped 100%"
Appears on Metrics	1-2 hours	Relay visible in search
First Statistics	24-48 hours	Bandwidth graphs appear
Guard Flag	8+ days	Trusted for entry connections

📖 Detailed monitoring: See Monitoring Guide for complete observability setup with Prometheus and Grafana.

▍ 🐛 Troubleshooting

Quick Diagnostics

# Check overall status
docker exec tor-relay status

# Check JSON health (raw)
docker exec tor-relay health

# View fingerprint
docker exec tor-relay fingerprint

# For bridge mode: Get bridge line
docker exec tor-relay bridge-line

# Generate Control Port hash
docker exec tor-relay gen-auth

Common Issues

Problem	Quick Fix
Container won't start	Check logs: `docker logs tor-relay`
ORPort not reachable	Verify firewall: `sudo ufw allow 9001/tcp`
Not on Tor Metrics	Wait 24h, verify bootstrap complete
Low/no traffic	Normal for new relays (2-8 weeks to build reputation)

📖 Full troubleshooting: See Tools Documentation for detailed diagnostic procedures.

▍ 🏢 Architecture and Design

📐 NEW: See the complete Architecture Documentation for detailed technical design with Mermaid diagrams covering:

Container lifecycle and initialization flow (6 phases)

ENV compatibility layer and configuration priority

Config generation for guard/exit/bridge modes

OBFS4V security validation (v1.1.1 fix)

Diagnostic tools architecture

Signal handling and graceful shutdown

▍ 📊 Flowchart

flowchart TB
    Start([🐳 docker run]) --> Init

    subgraph Init["⚙️ INITIALIZATION"]
        direction TB
        Check{"📄 Config File
        at /etc/tor/torrc?"}
        
        Check -->|✅ Mounted| Mount["📁 Use Mounted Config
        Full Tor Control"]
        Check -->|❌ No File| Env{"🌐 ENV Variables?
        NICKNAME + CONTACT_INFO"}
        
        Env -->|✅ Set| Generate["⚙️ Auto-Generate torrc
        from ENV Variables"]
        Env -->|❌ Missing| Error["❌ ERROR
        No Configuration Found"]
        
        Mount --> Validate
        Generate --> Validate
        Validate["🧪 Validate Config
        tor --verify-config"]
        Validate -->|❌ Invalid| Error
    end

    Init -->|✅ Valid Config| ModeSelect

    subgraph ModeSelect["🎯 RELAY MODE SELECTION"]
        direction LR
        Mode{TOR_RELAY_MODE}
        
        Mode -->|guard| Guard["🛡️ GUARD/MIDDLE
        ━━━━━━━━━━
        Routes Traffic
        ExitRelay 0
        DirPort Enabled"]
        Mode -->|exit| Exit["🚪 EXIT RELAY
        ━━━━━━━━━━
        Last Hop to Internet
        ExitRelay 1
        Custom Exit Policy"]
        Mode -->|bridge| Bridge["🌉 BRIDGE + obfs4
        ━━━━━━━━━━
        Censorship Resistant
        BridgeRelay 1
        Lyrebird Transport"]
    end

    Guard --> Running
    Exit --> Running
    Bridge --> Running

    Running(["🟢 TOR RELAY RUNNING"])
    
    Running --> Ops

    subgraph Ops["🛠️ OPERATIONS"]
        direction TB
        Tools["🔧 Diagnostic Tools
        via docker exec"]
        
        Tools --> Status["📊 status
        ━━━━━━━━━━
        Full Health Report
        Bootstrap Progress
        Reachability Status"]
        Tools --> Health["💚 health
        ━━━━━━━━━━
        JSON Health API
        For Monitoring Systems"]
        Tools --> Finger["🆔 fingerprint
        ━━━━━━━━━━
        Show Relay Identity
        Tor Metrics URL"]
        Tools --> BLine["🌉 bridge-line
        ━━━━━━━━━━
        Get obfs4 Bridge Line
        Share with Users"]
        Tools --> GenAuth["🔑 gen-auth
        ━━━━━━━━━━
        Generate Control
        Port Auth Data"]
    end

    Running -->|docker stop SIGTERM| Shutdown

    subgraph Shutdown["🧹 GRACEFUL SHUTDOWN"]
        direction TB
        Graceful["Close Circuits Cleanly
        Notify Directory Authorities
        Save State to Disk
        Exit Gracefully"]
    end

    Error --> End([⛔ Container Exits])
    Graceful --> End2([✅ Clean Stop])

    style Start fill:#4FC3F7,stroke:#0288D1,stroke-width:3px,color:#000
    style Running fill:#66BB6A,stroke:#388E3C,stroke-width:3px,color:#fff
    
    style Mount fill:#81C784,stroke:#388E3C,stroke-width:2px,color:#000
    style Generate fill:#81C784,stroke:#388E3C,stroke-width:2px,color:#000
    style Validate fill:#FFD54F,stroke:#F57C00,stroke-width:2px,color:#000
    style Error fill:#E57373,stroke:#C62828,stroke-width:3px,color:#fff
    
    style Guard fill:#64B5F6,stroke:#1976D2,stroke-width:2px,color:#000
    style Exit fill:#F06292,stroke:#C2185B,stroke-width:2px,color:#fff
    style Bridge fill:#BA68C8,stroke:#7B1FA2,stroke-width:2px,color:#fff
    
    style Status fill:#4DD0E1,stroke:#0097A7,stroke-width:2px,color:#000
    style Health fill:#4DD0E1,stroke:#0097A7,stroke-width:2px,color:#000
    style Finger fill:#4DD0E1,stroke:#0097A7,stroke-width:2px,color:#000
    style BLine fill:#4DD0E1,stroke:#0097A7,stroke-width:2px,color:#000
    style GenAuth fill:#4DD0E1,stroke:#0097A7,stroke-width:2px,color:#000
    
    style Graceful fill:#FFB74D,stroke:#F57C00,stroke-width:2px,color:#000
    style End fill:#E57373,stroke:#C62828,stroke-width:2px,color:#fff
    style End2 fill:#66BB6A,stroke:#388E3C,stroke-width:2px,color:#fff
    
    style Init fill:#FFF9C4,stroke:#F9A825,stroke-width:2px
    style ModeSelect fill:#E1BEE7,stroke:#8E24AA,stroke-width:2px
    style Ops fill:#B2EBF2,stroke:#00ACC1,stroke-width:2px
    style Shutdown fill:#FFCCBC,stroke:#E64A19,stroke-width:2px

Why Host Network Mode?

This project uses --network host for important reasons:

✅ IPv6 Support - Direct access to host's IPv6 stack
✅ No NAT - Tor binds directly to ports without translation
✅ Better Performance - Eliminates network overhead
✅ Tor Recommended - Follows Tor Project best practices

Security: The container still runs as non-root with restricted permissions. Host networking is standard for Tor relays.

Multi-Architecture Support

Docker automatically pulls the correct architecture:

# Same command works on:
# - x86_64 servers (pulls amd64)
# - Raspberry Pi (pulls arm64)
# - AWS Graviton (pulls arm64)
docker pull r3bo0tbx1/onion-relay:latest

Verify what you got:

docker exec tor-relay cat /build-info.txt | grep Architecture

▍ 🤝 Contributing

Contributions are welcome.

🐛 Report bugs via GitHub Issues
💡 Suggest features or improvements
📖 Improve documentation (typos, clarity, examples)
🔧 Submit pull requests (code, configs, workflows)
⭐ Star the repository to show support
🧅 Run a relay and strengthen the network!

Development Setup

# Clone repository
git clone https://github.com/r3bo0tbx1/tor-guard-relay.git
cd tor-guard-relay

# Build locally
docker build -t tor-relay:dev .

# Test
docker run --rm tor-relay:dev status

See Contributing Guide for detailed instructions.

▍ 📦 Templates and Examples

All templates are in the templates/ directory:

Docker Compose

docker-compose.yml - Single relay
docker-compose-multi-relay.yml - 3 relays + monitoring

Cosmos Cloud

cosmos-compose.json - Single relay
cosmos-compose-multi-relay.json - Multi-relay stack

Monitoring

See Monitoring Guide for external monitoring integration examples with Prometheus, Nagios, and other tools

Configuration Examples

See examples/ directory for relay configurations.

▍ 🔐 Security

Best Practices

✅ Store relay.conf with restricted permissions (chmod 600)
✅ Never commit configs with sensitive info to Git
✅ Use PGP key in ContactInfo for verification
✅ Regularly update Docker image for security patches
✅ Monitor logs for suspicious activity
✅ Configure firewall properly

Security Policy

Found a vulnerability? See our Security Policy for responsible disclosure.

Updates

Images are automatically rebuilt on separate schedules to include security patches:

Stable Variant (:latest)

Schedule: Every Sunday at 18:30 UTC
Includes: Latest Tor + Alpine 3.23.0 updates
Strategy: Overwrites last release version (e.g., :1.1.3) with updated packages
Tags Updated: :latest and version tags (e.g., :1.1.3)

Edge Variant (:edge)

Schedule: Every 3 days at 12:00 UTC (independent schedule)
Includes: Latest Tor + Alpine edge (bleeding-edge) updates
Strategy: Overwrites last release version (e.g., :1.1.3-edge) with updated packages
Tags Updated: :edge and version tags (e.g., :1.1.3-edge)
Frequency: ~2-3x more frequent updates than stable

All images auto-published to Docker Hub and GitHub Container Registry

▍ 🌐 Resources

Container Registries

🐳 Docker Hub Repository
📦 GitHub Container Registry

Official Tor Project

This Project

▍ 📊 Project Status

Current Version: v1.1.3 • Status: Production Ready
Image Size: 16.8 MB • Rebuild: Weekly
Registries: Docker Hub • GHCR

▍ 📄 License

Project is licensed under the MIT License.
See License for full details.

▍ 🙏 Acknowledgments

The Tor Project for maintaining the global privacy network
Alpine Linux for a minimal and secure base image
azukaar for Cosmos Cloud
All relay operators supporting privacy and anti-censorship worldwide

▍ 💖 Support the Project

This project is open source. Your support helps sustainability and improvements.

Bitcoin (BTC)

bc1qltkajaswmzx9jwets8hfz43nkvred5w92syyq4

Or via AnonPay (convert any crypto)

Monero (XMR)

45mNg5cG1S2B2C5dndJP65SSEXseHFVqFdv1N6paAraD1Jk9kQxQQArVcjfQmgCcmthrUF3jbNs74c5AbWqMwAAgAjDYzrZ

Or via AnonPay (convert any crypto)

Other Ways to Support

⭐ Star the repo
🐛 Report bugs
💡 Suggest features
📖 Improve documentation
🤝 Submit patches
🧅 Run a relay

▍ ⭐ Star History

Made with 💜 for a freer, uncensored internet

Protecting privacy, one relay at a time 🔁🧅✨

⭐ Star this repo if you find it useful!

🌍 Support Internet Freedom
📚 Documentation
⬆ Back to top

Name		Name	Last commit message	Last commit date
Latest commit History 125 Commits
.github		.github
docs		docs
examples		examples
scripts		scripts
src		src
templates		templates
tools		tools
.dockerignore		.dockerignore
.gitattributes		.gitattributes
.gitignore		.gitignore
.hadolint.yaml		.hadolint.yaml
CHANGELOG.md		CHANGELOG.md
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile.edge		Dockerfile.edge
LICENSE.txt		LICENSE.txt
README.md		README.md
SECURITY.md		SECURITY.md
docker-entrypoint.sh		docker-entrypoint.sh
healthcheck.sh		healthcheck.sh

Uh oh!

License

r3bo0tbx1/tor-guard-relay

Folders and files

Latest commit

History

Repository files navigation

🧅 Tor Guard Relay

Why Choose This Project?

System Requirements

Network Security Notes

Interactive Quick Start (Recommended for Beginners)

Manual Deployment

Step 2: Run (Docker Hub)

Step 3: Verify it's running:

Stable Variant (Recommended)

Edge Variant (Testing Only)

Multi-Relay Setup

Real-Time Monitoring (Nyx)

JSON Health API

Integration Examples

Security & Reliability

Operations & Automation

Developer Experience

Getting Started

Technical Reference

Legal & Community

Project Info

Minimal Configuration

Production Configuration

Example Configurations

Check Bootstrap Status

View on Tor Metrics

Expected Timeline

Quick Diagnostics

Common Issues

Why Host Network Mode?

Multi-Architecture Support

Development Setup

Docker Compose

Cosmos Cloud

Monitoring

Configuration Examples

Best Practices

Security Policy

Updates

Container Registries

Official Tor Project

This Project

Bitcoin (BTC)

Monero (XMR)

Other Ways to Support

About

Topics

Resources

License

Code of conduct

Contributing

Security policy

Uh oh!

Stars

Watchers

Forks

Releases 13

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Uh oh!

Contributors 3

Uh oh!

Languages

Packages