ZeroNet

简体中文 Русский

Decentralized websites using Bitcoin crypto and the BitTorrent network - https://zeronet.io

Why?

We believe in open, free, and uncensored network and communication.
No single point of failure: Site remains online so long as at least 1 peer is serving it.
No hosting costs: Sites are served by visitors.
Impossible to shut down: It's nowhere because it's everywhere.
Fast and works offline: You can access the site even if Internet is unavailable.

Features

Real-time updated sites
Namecoin .bit domains support
Easy to setup: unpack & run
Clone websites in one click
Password-less BIP32 based authorization: Your account is protected by the same cryptography as your Bitcoin wallet
Built-in SQL server with P2P data synchronization: Allows easier site development and faster page load times
Anonymity: Full Tor network support with .onion hidden services instead of IPv4 addresses
TLS encrypted connections
Automatic uPnP port opening
Plugin for multiuser (openproxy) support
Works with any browser/OS

How does it work?

After starting zeronet.py you will be able to visit zeronet sites using http://127.0.0.1:43110/{zeronet_address} (eg. http://127.0.0.1:43110/1HeLLo4uzjaLetFx6NH3PMwFP3qbRbTf3D).
When you visit a new zeronet site, it tries to find peers using the BitTorrent network so it can download the site files (html, css, js...) from them.
Each visited site is also served by you.
Every site contains a content.json file which holds all other files in a sha512 hash and a signature generated using the site's private key.
If the site owner (who has the private key for the site address) modifies the site, then he/she signs the new content.json and publishes it to the peers. Afterwards, the peers verify the content.json integrity (using the signature), they download the modified files and publish the new content to other peers.

Slideshow about ZeroNet cryptography, site updates, multi-user sites »

Frequently asked questions »

ZeroNet Developer Documentation »

Screenshots

More screenshots in ZeroNet docs »

How to join

Download ZeroBundle package:
Unpack anywhere
Run ZeroNet.exe (win), ZeroNet(.app) (osx), ZeroNet.sh (linux)

Linux terminal on x86-64

wget https://github.com/HelloZeroNet/ZeroBundle/raw/master/dist/ZeroBundle-linux64.tar.gz
tar xvpfz ZeroBundle-linux64.tar.gz
cd ZeroBundle
Start with ./ZeroNet.sh

It downloads the latest version of ZeroNet then starts it automatically.

Manual install for Debian Linux

sudo apt-get update
sudo apt-get install msgpack-python python-gevent
wget https://github.com/HelloZeroNet/ZeroNet/archive/master.tar.gz
tar xvpfz master.tar.gz
cd ZeroNet-master
Start with python2 zeronet.py
Open http://127.0.0.1:43110/ in your browser

Whonix

Instructions

Arch Linux

git clone https://aur.archlinux.org/zeronet.git
cd zeronet
makepkg -srci
systemctl start zeronet
Open http://127.0.0.1:43110/ in your browser

See ArchWiki's ZeroNet article for further assistance.

Gentoo Linux

eselect repository enable raiagent
emerge --sync
echo 'net-vpn/zeronet' >> /etc/portage/package.accept_keywords
(Optional) Enable Tor support: echo 'net-vpn/zeronet tor' >> /etc/portage/package.use
emerge zeronet
rc-service zeronet start
(Optional) Enable zeronet at runlevel "default": rc-update add zeronet
Open http://127.0.0.1:43110/ in your browser

See /usr/share/doc/zeronet-*/README.gentoo.bz2 for further assistance.

FreeBSD

pkg install zeronet or cd /usr/ports/security/zeronet/ && make install clean
sysrc zeronet_enable="YES"
service zeronet start
Open http://127.0.0.1:43110/ in your browser

Vagrant

vagrant up
Access VM with vagrant ssh
cd /vagrant
Run python2 zeronet.py --ui_ip 0.0.0.0
Open http://127.0.0.1:43110/ in your browser

Docker

docker run -d -v <local_data_folder>:/root/data -p 26552:26552 -p 127.0.0.1:43110:43110 nofish/zeronet
This Docker image includes the Tor proxy, which is disabled by default. Beware that some hosting providers may not allow you running Tor in their servers. If you want to enable it, set ENABLE_TOR environment variable to true (Default: false). E.g.:

docker run -d -e "ENABLE_TOR=true" -v <local_data_folder>:/root/data -p 26552:26552 -p 127.0.0.1:43110:43110 nofish/zeronet

Open http://127.0.0.1:43110/ in your browser

Virtualenv

virtualenv env
source env/bin/activate
pip install msgpack gevent
python2 zeronet.py
Open http://127.0.0.1:43110/ in your browser

Current limitations

~~No torrent-like file splitting for big file support~~ (big file support added)
~~No more anonymous than Bittorrent~~ (built-in full Tor support added)
File transactions are not compressed ~~or encrypted yet~~ (TLS encryption added)
No private sites

How can I create a ZeroNet site?

Shut down zeronet if you are running it already

$ zeronet.py siteCreate
...
- Site private key: 23DKQpzxhbVBrAtvLEc2uvk7DZweh4qL3fn3jpM3LgHDczMK2TtYUq
- Site address: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
- Site created!
$ zeronet.py
...

Congratulations, you're finished! Now anyone can access your site using http://localhost:43110/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2

Next steps: ZeroNet Developer Documentation

How can I modify a ZeroNet site?

Modify files located in data/13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2 directory. After you're finished:

$ zeronet.py siteSign 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
- Signing site: 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2...
Private key (input hidden):

Enter the private key you got when you created the site, then:

$ zeronet.py sitePublish 13DNDkMUExRf9Xa9ogwPKqp7zyHFEqbhC2
...
Site:13DNDk..bhC2 Publishing to 3/10 peers...
Site:13DNDk..bhC2 Successfuly published to 3 peers
- Serving files....

That's it! You've successfully signed and published your modifications.

Help keep this project alive

Bitcoin: 1QDhxQ6PraUZa21ET5fYUCPgdrwBomnFgX
Paypal: https://zeronet.io/docs/help_zeronet/donate/

zf192 / ZeroNet