Onionr/README.md

171 lines
8.0 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">
Privacy Respecting Communication Network 📡
</p>
2020-02-04 06:59:52 +00:00
<p align="center">
2022-03-28 05:13:03 +00:00
WIP anonymous social platform, mail, file sharing and marketplace
2020-02-04 06:59:52 +00:00
</p>
2022-08-16 21:24:13 +00:00
<img src="https://img.shields.io/badge/License-aGPLv3-yellow"> <img src='https://img.shields.io/badge/python%20version%20%F0%9F%90%8D-3.10+-blue'>
2019-08-30 09:47:23 +00:00
2022-03-16 05:57:05 +00:00
<a href='https://twitter.com/onionrnet'><img src='https://img.shields.io/twitter/follow/onionrnet?style=social'></a> - [Discord](https://discord.gg/DVF2bEAzrt) - Matrix: #onionr:amorgan.xyz
2019-08-30 09:47:23 +00:00
| | | |
| ----------- | ----------- | ----------- |
| [Install](#install-and-run-on-linux) | [Features](#main-features) | [Screenshots](#screenshots)|
2022-08-16 21:01:00 +00:00
| [Docs](#documentation) | [Get involved](#help-out) | [Onionr.net](https://onionr.net/)/[.onion](http://onionrbak72t5zhbzuey2fdkpczlvhowgcpqc6uoyrd3uxztzxwz5cyd.onion/) |
2018-09-07 04:57:10 +00:00
2018-04-01 06:40:31 +00:00
2021-02-01 04:58:07 +00:00
---
2022-08-16 21:01:00 +00:00
**The main repository for this software is at https://gitlab.com/beardog/onionr/**
2019-08-30 00:37:39 +00:00
2022-03-16 05:57:05 +00:00
***Note that this README reflects the state of the rewrite, and not the original alpha network***
2022-08-16 21:01:00 +00:00
Mirrors [Gitea](https://git.voidnet.tech/kev/onionr)
2019-10-04 21:49:35 +00:00
Onionr ("Onion Relay") is a decentralized/distributed peer-to-peer communication network, designed to be anonymous and resistant to (meta)data analysis, spam, and corruption.
2021-02-01 04:58:07 +00:00
Onionr gives the individual the ability to speak freely, without fear of surveillance and censorship.
2021-02-01 04:58:07 +00:00
---
2022-03-16 05:57:05 +00:00
# Onionr internals
## Blocks
2022-03-16 05:57:05 +00:00
At the core, Onionr is an anonymous Distributed Hash Table (DHT) syncing prepackaged blocks using a simple Gossip protocol with Dandelion++ as an overlay network on top of Tor and I2P.
Onionr stores data in independent packages referred to as 'blocks'. The blocks are distributed to all nodes, but are not required to be stored. Blocks and user IDs cannot be easily proven to have been created by a particular user. Even if Dandelion++ is defeated and there is enough evidence to believe that a specific node is linked to a block's creation, nodes still operate behind Tor or I2P and as such cannot be trivially unmasked. Anonymity is achieved by a stateless network, with no given indication of what node a block originates from. In fact, since one is not required to participate in routing or storage to insert a message, blocks often do not originate from any identifiable node, similar to how Bitcoin transactions do not necessarily originate from a wallet directly associated with a node.
2022-03-16 05:57:05 +00:00
## Onionr Gossip
2021-02-01 04:58:07 +00:00
2022-03-16 05:57:05 +00:00
Onionr works via epidemic/gossip style routing, with message delivery taking roughly log<sub>C</sub>(N) cycles where C is the number of nodes to send a message to each cycle and N is the number of connected nodes. So a network of 100 million nodes can deliver messages in a few minutes even with high packet loss and malfunctioning nodes.
2021-02-01 04:58:07 +00:00
2022-03-16 05:57:05 +00:00
Through Dandelion++ message forwarding and key privacy, it is intended to be nigh impossible to discover the identity of a message creator or recipient. Via long-term traffic analysis, a well funded adversary may discover the most probable node(s) to be creating a set of related blocks, however doing so would only lead them to a node behind Tor. As the first node that a block appears on is almost always not the creator of the block, there is plausible deniability regarding the true creator of the block.
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
2022-03-16 05:57:05 +00:00
Since Onionr is technically just a data format, any routing scheme can technically be used to pass messages.
2020-10-09 06:39:32 +00:00
The whitepaper is available [here](docs/whitepaper.md).
2021-02-01 04:58:07 +00:00
---
2022-03-16 05:57:05 +00:00
# Main Features
2019-03-05 06:06:49 +00:00
* [X] 🌐 Fully p2p/decentralized, no trackers or other single points of failure
* [X] 🕵️ Metadata analysis resistance and anonymity
* [X] 📡 Transport agnosticism (no internet required)
2019-03-05 06:06:49 +00:00
2022-03-16 05:57:05 +00:00
# Roadmap
2019-03-05 06:06:49 +00:00
2022-03-28 05:13:03 +00:00
See [ROADMAP.md](ROADMAP.md)
2019-03-05 06:06:49 +00:00
# Documentation
More docs coming soon.
# Install and Run on Linux
The following applies to Ubuntu Bionic. Other distributions may have different package or command names.
Master may be unstable, you should use the latest release tag. (checkout via git: `$ git checkout release-latest`)
`$ sudo apt install python3-pip python3-dev tor`
2022-08-16 21:24:13 +00:00
* Have python3.10, python3-pip, Tor (daemon, not browser) installed. python3-dev is recommended.
2021-01-16 01:40:37 +00:00
* You may need build-essentials or the equivalent of your platform
2022-08-16 21:01:00 +00:00
* Clone the git repo: `$ git clone https://gitlab.com/beardog/onionr --tags`
* 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-x86-all-plugins.txt`
Require-hashes is suggested for supply-chain security but is optional. The hashes are not correct for ARM machines. If you are just running a node or want a bare-bones install you can use requirements-base-x86.txt and selectively install the requirements.txt files in static-data/official-plugins/ subdirectories
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`
* Gracefully stop Onionr from CLI `$ ./onionr.sh stop`
2019-08-11 02:11:26 +00:00
2019-10-17 10:00:50 +00:00
2021-01-11 04:55:39 +00:00
# Contact/Community
2019-10-17 10:00:50 +00:00
2022-03-16 05:57:05 +00:00
* Email: onionr [ at ] voidnet.tech
2021-01-11 04:55:39 +00:00
* Twitter: [@onionrnet](https://twitter.com/onionrnet)
2021-01-16 01:40:37 +00:00
* Matrix: #onionr:amorgan.xyz
2022-03-28 05:13:03 +00:00
* Discord: https://discord.gg/DVF2bEAzrt (Discord is bad for freedom and privacy, this is only provided for convenience)
2019-10-17 10:00:50 +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
2022-03-16 05:57:05 +00:00
* Mac support (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
2020-06-26 00:42:02 +00:00
* I2P support
2018-04-01 06:40:31 +00:00
2021-01-16 01:40:37 +00:00
## Watch the talk from BSidesPDX 2019
<a href="https://www.youtube.com/watch?v=mrULtmSkKxg">
<img src="docs/talk.png" alt="improving anonymous networking talk link" width="600">
</a>
2019-06-17 07:40:32 +00:00
## Contribute money:
2019-03-05 06:06:49 +00:00
2019-10-17 10:00:50 +00:00
Donating at least $3 gets you cool Onionr stickers. Get in touch if you want them.
2019-10-16 08:20:07 +00:00
![sticker](docs/sticker.png)
2019-03-05 06:06:49 +00:00
2022-03-16 05:57:05 +00:00
* Bitcoin: [bc1qpayme9rlpkch0qp3r79lvm5racr7t6llauwfmg](bitcoin:bc1qpayme9rlpkch0qp3r79lvm5racr7t6llauwfmg) (Contact us for a unique address or for other coins)
2021-01-11 04:55:39 +00:00
* Monero: 4B5BA24d1P3R5aWEpkGY5TP7buJJcn2aSGBVRQCHhpiahxeB4aWsu15XwmuTjC6VF62NApZeJGTS248RMVECP8aW73Uj2ax
2019-03-05 06:06:49 +00:00
2021-02-01 04:58:07 +00:00
* USD (Card/Paypal (no account required)): [Ko-Fi](https://www.ko-fi.com/beardogkf)
2021-01-11 04:55:39 +00:00
2021-02-01 04:58:07 +00:00
* Sign up for [privacy.com (refferal link)](https://privacy.com/join/FNNDF) to protect your personal information when contributing or shopping elsewhere, we both get $5 USD.
2019-03-05 06:06:49 +00:00
2022-03-16 05:57:05 +00:00
Note: not tax deductible
2019-03-05 15:57:07 +00:00
2019-08-30 09:47:23 +00:00
# Security
2020-02-04 06:59:52 +00:00
Onionr is alpha software. 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/).
2019-03-13 21:10:11 +00:00
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.