ZeroNet: Decentralized Censorship-resistant Network
The ZeroNet wiki describes the software design: 
ZeroNet uses Bitcoin cryptography and BitTorrent technology to build a decentralized censorship-resistant network. Users can publish static or dynamic websites in ZeroNet and visitors can choose to also serve the website. Websites will remain online even if it is being served by only one peer.
This means users are not identified or reachable by an IP address, since they are identified by a public key - specifically a public Bitcoin address. The private key owner can sign and publish changes, which are propagated through the network. Sites are accessed through an ordinary browser in combination with the Zeronet application.  The BitTorrent technology refers to the use of trackers to negotiate peer connections.  ZeroNet can be optionally configured to use Tor for anonymity. 
The Zeronet wiki describes various features and benefits, including: 
- Password-less authorization - the user account is protected by the same cryptography that applies to Bitcoin wallets.
- Easy setup. 
- Immediate updating of sites in real time.
- Works with any browser.
- Full Tor network support, including onion services.
- Content cannot be censored (removed) after publication.
- It is impossible to shut down content, since content is served by any user who wishes to.
- ZeroNet is fast and works offline.
Connecting to Tor before ZeroNet
These instructions lead to the following connection scheme in Whonix:
Complete the following steps in Whonix-Gateway (
Extend onion-grater Whitelist
To download and verify ZeroNet via git, run the following commands in Whonix-Workstation (
Update the package lists.
sudo apt-get update
sudo apt-get install git python-msgpack python-gevent
Qubes-Whonix: This step can be completed in the ZeroNet qube (AppVM;
Retrieve the ZeroNet signing key. 
gpg --recv-keys "960F FF2D 6C14 5AA6 13E8 491B 5B63 BAE6 CB96 13AE"
git clone https://github.com/HelloZeroNet/ZeroNet.git
Navigate to the ZeroNet folder.
Check the ZeroNet signature.
git log --show-signature
./zeronet.py --tor always --fileserver_ip $(qubesdb-read /qubes-ip)
./zeronet.py --tor always --fileserver_ip 10.152.152.11
Note: The following steps will no longer be required once Whonix releases a custom Tor Browser for connecting to alternative networks. 
Configure Tor Browser to connect to localhost.
In Tor Browser:
about:configinto the URL bar.
- Search for
- Set to
Start Tor Browser.
The process is now complete and ZeroNet should be fully functional in Whonix. 
- ZeroNet acts as a local web server for these pages.
- Although the Chinese government has blocked the ZeroNet website and bittorrent tracker.
/usr/local/etc/onion-grater-merger.d/because that onion-grater settings folder is persistent in Qubes-Whonix TemplateBased ProxyVMs, i.e. Whonix-Gateway (commonly called
sys-whonix). Non-Qubes-Whonix users could also use
/etc/onion-grater-merger.d/. Qubes-Whonix users could also use
/etc/onion-grater-merger.d/but then users would have to make
/etc/onion-grater-merger.d/persistent, which would require doing this inside the Whonix-Gateway TemplateVM (commonly called
whonix-gw-14) and restart their Whonix-Gateway ProxyVM or to use bind-dirs. Both is more complicated than simply using
/usr/local/etc/onion-grater-merger.d/which is persistent either way and even allows multiple Whonix-Gateway ProxyVMs based on the same Whonix-Gateway TemplateVM for lets say one Whonix-Gateway ProxyVM extending and relaxing onion-grater's whitelist and the other Whonix-Gateway ProxyVM with the default more restricted onion-grater whitelist.
- Except in the case of YaCy, which needs internet access.
- Functionality was last confirmed in May 2018.
Comments will be deleted after some time. Specifically after comments have been addressed in form of wiki enhancements. See Wiki Comments Policy.
This is a wiki. Want to improve this page? Help is welcome and volunteer contributions are happily considered! See Conditions for Contributions to Whonix, then Edit! IP addresses are scrubbed, but editing over Tor is recommended. Edits are held for moderation.
Whonix is provided by ENCRYPTED SUPPORT LP. See Imprint.