🌈 BifrostOS

Democratizing access to censorship-resistant networks

In an increasingly controlled world, free expression needs resilient spaces. BifrostOS makes anonymous networks accessible to everyone—not just technical users.

---

💡 Why BifrostOS?

The internet is becoming more centralized and surveilled every day. Access to information is being restricted. Freedom of expression is under threat.

BifrostOS was born to:

• 🌍 Democratize access to censorship-resistant networks
• 🛡️ Protect free expression in an increasingly controlled digital world
• 🤝 Unite communities working to keep these networks alive
• 🎓 Educate non-technical users about privacy tools
• 🐳 Simplify deployment without compromising personal data (Docker isolation)

We don't promote or encourage misuse of anonymous networks. We do believe that access to privacy tools should be a right, not a privilege reserved for technical experts.

Our Philosophy

• ✅ Accessibility over perfection - We're not the most anonymous, but we are the easiest
• ✅ Community-driven - Uniting efforts across Tor, I2P, Hyphanet, and ZeroNet communities
• ✅ Open to improvement - Security contributions and enhancements are welcome
• ✅ Pre-configured simplicity - One command, four networks, zero configuration

BifrostOS is a bridge. A bridge to knowledge, to freedom, to resilience.

---

🚀 Quick Start

Requirements

• Docker installed (Get Docker)
• 4GB RAM
• 5GB disk space

Install

Option 1: Automatic

git clone https://github.com/PoulLorca/BifrostOS.git
cd bifrostos
./install.sh

Option 2: Docker Compose

git clone https://github.com/PoulLorca/BifrostOS.git
cd bifrostos
docker compose up -d

Option 3: Direct

docker run -d \
  --name bifrostos \
  -p 6080:6080 \
  -p 5901:5901 \
  -p 9050:9050 \
  -p 7070:7070 \
  -p 4444:4444 \
  -p 8888:8888 \
  -p 43110:43110 \
  bifrostos/bifrostos:latest

Access

Open your browser: http://localhost:6080

Password (if asked): bifrost1

---

🌉 The Four Bridges

BifrostOS gives you instant access to four resilient networks:

Network	Ready in	What it does
🟣 Tor	30 sec	Anonymous browsing and .onion sites
🔵 I2P	5-10 min	Fully encrypted distributed network
🟢 Hyphanet	15-20 min	Decentralized censorship-resistant storage
🔷 ZeroNet	2-3 min	P2P websites using Bitcoin + BitTorrent

Each network serves different purposes. Each network is maintained by dedicated communities fighting for a free internet.

---

🎮 How to Use

1. Open http://localhost:6080 in your browser
2. Wait for the desktop to load (~30 seconds)
3. Double-click "BifrostOS Control Panel" on the desktop
4. See real-time network status
5. Click "Open" buttons to access each network

That's it. No configuration needed.

---

🔧 Basic Commands

# View logs
docker compose logs -f

# Stop
docker compose down

# Restart
docker compose restart

# Update
docker pull bifrostos/bifrostos:latest
docker compose up -d

---

🛟 Troubleshooting

Port already in use?
Change ports in docker-compose.yml

Networks not connecting?
Wait! They need time to bootstrap (see times in table above)

Can't access the web interface?
Check Docker is running: docker ps

Need help?
Open an issue: GitHub Issues

---

📦 Technical Details

• Image size: 2.7 GB
• Base system: Alpine Linux (minimal, secure)
• Browser: LibreWolf (privacy-focused)
• Desktop: XFCE4 (lightweight)
• Access methods: noVNC (web) + VNC (direct)

Exposed Ports

• 6080 - Web interface (noVNC)
• 5901 - VNC direct access
• 9050 - Tor SOCKS proxy
• 7070 - I2P router console
• 4444 - I2P HTTP proxy
• 8888 - Hyphanet FProxy
• 43110 - ZeroNet web interface

All ports are required for proper network auto-configuration.

---

🔒 Security & Privacy

Important Notes

⚠️ BifrostOS prioritizes ease of use over maximum anonymity
⚠️ BifrostOS doesn't include IP obfuscation systems outside of the networks themselves
⚠️ No persistent storage - configurations and files are lost between sessions (no Docker volumes)
⚠️ Don't expose ports to the public internet without proper security
⚠️ Use Tor Browser within BifrostOS for maximum anonymity when needed
⚠️ Docker provides isolation - your personal data stays on your host system

For Enhanced Security

If you need maximum security:

1. Run BifrostOS on a dedicated machine or VM
2. Route all traffic through Tor
3. Don't save personal data inside the container

BifrostOS is an educational and accessibility tool. For high-security scenarios, consult security professionals.

---

🤝 Contributing

BifrostOS thrives on community contributions!

We welcome:

• 🐛 Bug reports
• 🔒 Security improvements
• 📖 Documentation enhancements
• 🌍 Translations
• 💡 Feature suggestions
• 🔧 Code contributions

Areas where we need help:

• Security hardening
• Network configuration optimization
• User interface improvements
• Testing on different platforms

See CONTRIBUTING.md for guidelines.

---

📜 License

MIT License - See LICENSE file

BifrostOS is free and open source. Forever.

---

🙏 Standing on the Shoulders of Giants

BifrostOS exists because of the tireless work of communities maintaining these networks.

We are deeply grateful to:

The Networks

• Tor Project - Fighting surveillance since 2002. The Tor community has defended privacy rights for millions worldwide.
• I2P - The Invisible Internet Project. Volunteers building truly anonymous communication infrastructure.
• Hyphanet (formerly Freenet) - 20+ years of decentralized, censorship-resistant publishing. A pioneer in digital freedom.
• ZeroNet Conservancy - Community continuing the P2P web vision. Keeping decentralized websites alive.

The Foundation

• Alpine Linux - Secure, minimal base system
• LibreWolf - Privacy-respecting browser
• noVNC - Browser-based VNC access

The Real Heroes

The developers, maintainers, node operators, and advocates who keep these networks running—often unpaid, always dedicated to the vision of a free internet.

Thank you.

Without your work, projects like BifrostOS wouldn't exist.

---

🌍 Join the Movement

BifrostOS is part of a larger movement to:

• Keep the internet free and open
• Protect privacy as a human right
• Resist censorship and surveillance
• Empower individuals with knowledge and tools

You can help by:

• Using and sharing BifrostOS
• Running Tor relays or I2P nodes
• Supporting the networks financially
• Teaching others about privacy tools
• Contributing to open source privacy projects

---

⚖️ Responsible Use

BifrostOS provides access to powerful privacy tools. With great power comes great responsibility.

We believe in:

✅ Freedom of expression
✅ Privacy as a human right
✅ Access to information
✅ Circumventing unjust censorship
✅ Protecting journalists, activists, and vulnerable people

We don't condone:

❌ Illegal activities
❌ Harassment or harm to others
❌ Distributing illegal content
❌ Attacking systems or networks

Users are responsible for their own actions. BifrostOS is a tool for freedom, not a shield for wrongdoing.

---

📞 Contact & Community

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 👥 Community: Join our Reddit
• 🐦 X (Twitter): @PoulLorca

---

🌈 Built with hope for a freer internet 🌈

"Like the rainbow bridge of Norse mythology, BifrostOS connects you to different worlds."