onionr/README.md

164 lines
6.8 KiB
Markdown
Raw Normal View History

<p align="center">
2018-03-03 09:38:27 +00:00
<img src="./docs/onionr-logo.png" width='250'>
</p>
<p align="center">
2019-08-27 08:24:51 +00:00
Private P2P Communication Network 📡
</p>
2019-08-30 21:25:07 +00:00
<img src='https://img.shields.io/github/license/beardog108/onionr'> <img src='https://gitlab.com/beardog/Onionr/badges/master/build.svg'> <img src='https://img.shields.io/badge/docker%20%F0%9F%90%8B-supported-success'> <img src='https://img.shields.io/badge/python%20version%20%F0%9F%90%8D-3.6+-blue'> <img src='https://img.shields.io/github/commit-activity/m/beardog108/onionr'>
2019-08-30 09:47:23 +00:00
<a href='https://www.reddit.com/r/onionr'><img src = 'https://img.shields.io/reddit/subreddit-subscribers/onionr?style=social'></a> <a href='https://twitter.com/onionrnet'><img src='https://img.shields.io/twitter/follow/onionrnet?style=social'></a>
2019-08-30 09:47:23 +00:00
| | | |
| ----------- | ----------- | ----------- |
| [Install](#install-and-run-on-linux) | [Features](#main-features) | [Screenshots](#screenshots)|
| [Docs](#documentation) | [Get involved](#help-out) | [Onionr.net](https://onionr.net/)/[.onion](http://onionr.onionkvc5ibm37bmxwr56bdxcdnb6w3wm4bdghh5qo6f6za7gn7styid.onion/) |
2018-09-07 04:57:10 +00:00
2018-04-01 06:40:31 +00:00
<hr>
2019-08-30 00:37:39 +00:00
**The main repository for this software is at https://GitLab.com/beardog/Onionr/**
2019-08-30 09:47:23 +00:00
**The [GitHub repository](https://github.com/beardog108/onionr/) is a mirror, do not submit PRs or issues there.**
2019-04-11 22:01:18 +00:00
# About
2019-09-09 08:54:55 +00:00
Onionr ("Onion Relay") is a decentralized, peer-to-peer communication network, designed to be anonymous and resistant to (meta)data analysis, spam, and corruption.
2019-04-11 22:01:18 +00:00
Onionr stores data in independent packages referred to as 'blocks'. The blocks are synced to all other nodes in the network. Blocks and user IDs cannot be easily proven to have been created by a particular user. Even if there is enough evidence to believe that a specific user created a block, nodes still operate behind Tor or I2P and as such cannot be trivially unmasked.
Users are identified by ed25519/curve25519 public keys, which can be used to sign blocks or send encrypted data.
Onionr can be used for mail, as a social network, instant messenger, file sharing software, or for encrypted group discussion.
2018-02-21 03:17:24 +00:00
The whitepaper (subject to change prior to alpha release) is available [here](docs/whitepaper.md).
![Tor stinks slide image](docs/tor-stinks-02.png)
## Main Features
2019-03-05 06:06:49 +00:00
* [X] 🌐 Fully p2p/decentralized, no trackers or other single points of failure
* [X] 🔒 End to end encryption of user data
* [X] 📢 Optional non-encrypted blocks, useful for blog posts or public file sharing
* [X] 💻 Easy HTTP API for integration to websites
2019-03-05 06:06:49 +00:00
* [X] 🕵️ Metadata analysis resistance and anonymity
* [X] 📡 Transport agnosticism (no internet required)
Onionr ships with various application plugins ready for use out of the box:
Currently usable:
* Mail
2019-08-25 08:08:09 +00:00
* Public anonymous chat/message board
2019-06-17 07:40:32 +00:00
* Simple webpage hosting - Will be greatly extended
* File sharing (Work in progress)
Not yet usable:
* Instant messaging
**Onionr API and functionality is subject to non-backwards compatible change during pre-alpha development**
2018-02-21 03:17:24 +00:00
2019-03-05 06:06:49 +00:00
# Screenshots
<img alt='Node statistics page screenshot' src='docs/onionr-1.png' width=600>
2019-07-13 06:35:49 +00:00
Home screen
2019-03-05 06:06:49 +00:00
<img alt='Friend/contact manager screenshot' src='docs/onionr-2.png' width=600>
Friend/contact manager
<img alt='Encrypted, metadata-masking mail application screenshot' src='docs/onionr-3.png' width=600>
2019-05-07 17:56:20 +00:00
Encrypted, metadata-masking mail application. One of the first distributed mail systems to have basic forward secrecy.
2019-03-05 06:06:49 +00:00
# Documentation
More docs coming soon.
* [Block specification](docs/specs/block-spec.md)
* [HTTP API](docs/http-api.md)
# Install and Run on Linux
The following applies to Ubuntu Bionic. Other distros may have different package or command names.
`$ sudo apt install python3-pip python3-dev tor`
* Have python3.6+, python3-pip, Tor (daemon, not browser) installed. python3-dev is recommended.
* Clone the git repo: `$ git clone https://gitlab.com/beardog/onionr`
* cd into install direction: `$ cd onionr/`
* Install the Python dependencies ([virtualenv strongly recommended](https://virtualenv.pypa.io/en/stable/userguide/)): `$ pip3 install --require-hashes -r requirements.txt`
* (Optional): Install desktop notification dependencies: `$ pip3 install --require-hashes -r requirements-notifications.txt`
(--require-hashes is intended to prevent exploitation via compromise of PyPi/CA certificates)
2018-01-20 07:23:09 +00:00
2019-08-11 02:11:26 +00:00
## Run Onionr
* Run Onionr normally: `$ ./onionr.sh start`
* Run Onionr in background as daemon: `$ ./start-daemon.sh`
* Open Onionr web interface `$ ./onionr.sh openhome`
* Gracefully stop Onionr from CLI `$ ./onionr.sh stop`
2019-08-11 02:11:26 +00:00
# Help out
2018-02-07 09:04:58 +00:00
Everyone is welcome to contribute. Help is wanted for the following:
* Development (Get in touch first)
2019-03-05 06:06:49 +00:00
* Creation of a shared lib for use from other languages and faster proof-of-work
* Android and IOS development
2019-03-05 06:06:49 +00:00
* Windows and Mac support (already partially supported, testers needed)
* Bug fixes and development of new features
* Testing
2019-07-02 23:55:09 +00:00
* Translations/localizations
2019-03-05 06:06:49 +00:00
* UI/UX design
* Running stable nodes
* Security review/audit
2019-02-03 18:19:50 +00:00
* Automatic I2P setup
2018-04-01 06:40:31 +00:00
2019-06-17 07:40:32 +00:00
## Contribute money:
2019-03-05 06:06:49 +00:00
Donating at least $5 gets you cool Onionr stickers. Get in touch if you want them.
Bitcoin: [1onion55FXzm6h8KQw3zFw2igpHcV7LPq](bitcoin:1onion55FXzm6h8KQw3zFw2igpHcV7LPq) (Contact us for a unique address or for other coins)
Monero: 4B5BA24d1P3R5aWEpkGY5TP7buJJcn2aSGBVRQCHhpiahxeB4aWsu15XwmuTjC6VF62NApZeJGTS248RMVECP8aW73Uj2ax
2019-03-05 06:06:49 +00:00
USD (Card/Paypal): [Ko-Fi](https://www.ko-fi.com/beardogkf)
2019-03-05 15:57:07 +00:00
Note: probably not tax deductible
2019-06-17 07:40:32 +00:00
# Contact
2019-03-05 06:06:49 +00:00
Email: beardog [ at ] mailbox.org
2018-04-01 06:40:31 +00:00
2019-06-26 04:48:24 +00:00
Onionr Mail: TRH763JURNY47QPBTTQ4LLPYCYQK6Q5YA33R6GANKZK5C5DKCIGQ
2019-06-17 07:40:32 +00:00
2019-08-30 09:47:23 +00:00
# Security
Onionr is pre-alpha. This means it is unstable, probably insecure, and experimental.
2019-05-13 05:01:37 +00:00
2019-08-08 06:25:48 +00:00
No matter how good Onionr and other software gets, there will always be ways for clever or well-funded adversaries to break your security.
Onionr does not protect your identity if you associate your user ID with your name either on Onionr or elsewhere.
2019-06-16 06:36:38 +00:00
*Do not rely on Onionr or any other software to hold up if your life or liberty are at stake.*
### Licenses and Branding
Onionr is published under the GNU GPL v3 license, except for the logo.
2018-01-20 07:23:09 +00:00
The Tor Project and I2P developers do not own, create, or endorse this project, and are not otherwise involved.
Tor is a trademark for the Tor Project. We do not own it.
2018-04-01 06:40:31 +00:00
2019-06-17 07:40:32 +00:00
## Onionr Logo
2019-03-13 21:10:11 +00:00
The Onionr logo was created by [Anhar Ismail](https://github.com/anharismail) under the [Creative Commons Attribution 4.0 International License](https://creativecommons.org/licenses/by/4.0/).
If you modify and redistribute our code ("forking"), please use a different logo and project name to avoid confusion. Please do not use the project name or logo in a way that makes it seem like we endorse you without our permission.