Private Decentralized Communication Network
Nie możesz wybrać więcej, niż 25 tematów Tematy muszą się zaczynać od litery lub cyfry, mogą zawierać myślniki ('-') i mogą mieć do 35 znaków.
Kevin a401f49da3 fix index.html not being auto loaded in subdirs 3 tygodni temu
.github Create stale.yml 4 miesięcy temu
.vscode added vscode files 5 miesięcy temu
docs Update todo 5 miesięcy temu
install added install readme disclaimer and don't log max thread messages to terminal 8 miesięcy temu
scripts moving to release with better settings and onboarding, add dev setup docs 5 miesięcy temu
src fix index.html not being auto loaded in subdirs 3 tygodni temu
static-data do not allow restart on windows 5 miesięcy temu
tests remove mergify 4 miesięcy temu
.dockerignore * cache pip requirements in dockerfile 1 rok temu
.env change env to 3.8 6 miesięcy temu
.gitignore added vscode files 5 miesięcy temu
.gitlab-ci.yml use python docker for CI instead of ubuntu 6 miesięcy temu
.onionr.yml Rename AUR package to onionr-git 11 miesięcy temu
AUTHORS.MD * started endpoint for non-app specific control of direct connections 10 miesięcy temu refactored onionr commands and other small adjustments 1 rok temu fixed some bugs 11 miesięcy temu
Dockerfile change dockerfile to python image, remove unnecessary apt installs 6 miesięcy temu Create an issue template 2 lat temu
LICENSE.txt Update LICENSE.txt 11 miesięcy temu
Makefile moved to niceware from mnemonic 9 miesięcy temu remove block count in readme 3 tygodni temu moved tests to parent directory 9 miesięcy temu added site lister 5 miesięcy temu renamed onionr dir and bugfixes/linting progress 7 miesięcy temu Bump pdoc3 from 0.7.4 to 0.7.5 4 miesięcy temu
requirements-dev.txt Bump pdoc3 from 0.7.4 to 0.7.5 4 miesięcy temu boards now load async 10 miesięcy temu
requirements-notifications.txt boards now load async 10 miesięcy temu Bump deadsimplekv from 0.3.0 to 0.3.1 3 miesięcy temu
requirements.txt Add hash to requirements.txt 2 miesięcy temu
run-windows-dev.bat renamed onionr dir and bugfixes/linting progress 7 miesięcy temu
run-windows.bat renamed onionr dir and bugfixes/linting progress 7 miesięcy temu moved tests to parent directory 9 miesięcy temu Merge Tempblocks 1 rok temu added restart command 9 miesięcy temu

Privacy Respecting Communication Network 📡

Anonymous social platform, mail, file sharing.

Install Features Screenshots
Docs/web copy Get involved

The main repository for this software is at

The GitHub repository is a mirror, do not submit PRs or issues there.


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.

Onionr stores data in independent packages referred to as ‘blocks’. The blocks are distributed to all interested nodes. 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. Anonymity is achieved by a stateless network, with no given indication of what node a block originates from. Through message mixing 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 or I2P. 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.

Onionr gives the individual the ability to speak freely, without fear of surveillance and censorship.

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.

The whitepaper is available here.

Tor stinks slide image

Main Features

Onionr ships with various application plugins ready for use out of the box:

Currently usable:

  • Mail
  • Public anonymous chat/message board
  • Simple webpage hosting - Will be greatly extended
  • File sharing (Work in progress)

Not yet usable:

  • Instant messaging

Watch the talk from BSidesPDX 2019

improving anonymous networking talk link


Node statistics page screenshot

Home screen

Friend/contact manager screenshot

Friend/contact manager

Encrypted, metadata-masking mail application screenshot

Encrypted, metadata-masking mail application. One of the first distributed mail systems to have basic forward secrecy.


More docs coming soon.

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.7+, python3-pip, Tor (daemon, not browser) installed. python3-dev is recommended.
  • Clone the git repo: $ git clone
  • cd into install direction: $ cd onionr/
  • Install the Python dependencies (virtualenv strongly recommended): $ 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)

Run Onionr

  • Run Onionr normally: $ ./ start
  • Run Onionr in background as daemon: $ ./
  • Open Onionr web interface $ ./ openhome
  • Gracefully stop Onionr from CLI $ ./ stop


Email: beardog [ at ]

Onionr Mail: particularizing-zabaione-defuze-iodizer-saucepan-patientest-sell-waken-chifforobe-embonpoint-aquanaut-chambermaid-barky-fumer-jolt-biotic

Help out

Everyone is welcome to contribute. Help is wanted for the following:

  • Development (Get in touch first)
    • Creation of a shared lib for use from other languages and faster proof-of-work
    • Android and IOS development
    • Windows and Mac support (already partially supported, testers needed)
    • Bug fixes and development of new features
  • Testing
  • Translations/localizations
  • UI/UX design
  • Running stable nodes
  • Security review/audit
  • Automatic I2P setup

Contribute money:

Donating at least $3 gets you cool Onionr stickers. Get in touch if you want them.


Bitcoin: 1onion55FXzm6h8KQw3zFw2igpHcV7LPq (Contact us for a unique address or for other coins)

Monero: 4B5BA24d1P3R5aWEpkGY5TP7buJJcn2aSGBVRQCHhpiahxeB4aWsu15XwmuTjC6VF62NApZeJGTS248RMVECP8aW73Uj2ax

USD (Card/Paypal): Ko-Fi

Note: probably not tax deductible


Onionr is alpha software. This means it is unstable, probably insecure, and experimental.

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.

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.

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.

The Onionr logo was created by Anhar Ismail under the Creative Commons Attribution 4.0 International License.

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.