ZeroNet - Decentralized websites using Bitcoin crypto and BitTorrent network
Go to file
shortcutme 38e20b7c31
Rev4206
2019-09-04 20:16:57 +02:00
.github/ISSUE_TEMPLATE Added issue templates for suggestions (#1814) 2018-12-12 17:58:40 +01:00
plugins Open sidebar with location hash 2019-09-02 14:17:35 +02:00
src Rev4206 2019-09-04 20:16:57 +02:00
tools/coffee Remove tor files 2018-04-29 15:31:30 +02:00
.gitignore Add GitLab CI/CD support (#2163) 2019-08-19 17:30:31 +02:00
.gitlab-ci.yml Add GitLab CI/CD support (#2163) 2019-08-19 17:30:31 +02:00
.travis.yml Try use pypi gevent for py3.8 tests 2019-07-10 12:48:08 +02:00
CHANGELOG.md 0.6.4 Changelog 2018-10-23 23:59:32 +02:00
Dockerfile Fix the order of commands in Dockerfile to make use of the caching of intermediate Docker images. 2019-07-03 19:18:54 +07:00
LICENSE Initial commit 2015-01-12 01:41:38 +01:00
README-ru.md Change docs url to self hosted 2018-11-08 02:43:51 +01:00
README-zh-cn.md Change docs url to self hosted 2018-11-08 02:43:51 +01:00
README.md Correct venv install 2019-08-06 14:56:45 +02:00
Vagrantfile Use msgpack pip package everywhere 2018-02-27 02:48:15 +01:00
requirements.txt requirements: main websocket package 2019-03-30 09:50:10 -04:00
start.py Fix starting ZeroNet via start.py (#2052) 2019-06-28 00:58:58 +02:00
update.py Support updating linux bundle 2019-09-04 20:15:49 +02:00
zeronet.py Formatting 2019-09-04 20:13:32 +02:00

README.md

ZeroNet Build Status Documentation Help

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

Screenshot ZeroTalk

More screenshots in ZeroNet docs »

How to join

Windows

Other platforms: Install from source

Fetch and extract the source:

wget https://github.com/HelloZeroNet/ZeroNet/archive/py3/ZeroNet-py3.tar.gz
tar xvpfz ZeroNet-py3.tar.gz
cd ZeroNet-py3

Install Python module dependencies either:

  • (Option A) into a virtual env

    python3 -m venv zeronet
    source zeronet/bin/activate
    python3 -m pip install -r requirements.txt
    
  • (Option B) into the system (requires root), for example, on Debian/Ubuntu:

    sudo apt-get update
    sudo apt-get install python3-pip
    sudo python3 -m pip install -r requirements.txt
    

Start Zeronet:

python3 zeronet.py

Open the ZeroHello landing page in your browser by navigating to:

http://127.0.0.1:43110/

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

Sponsors

Thank you!