Private Decentralized Communication Network
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Arinerron 39ac87b6ad
Improve logging, mostly
1 year ago
.github corrected permissions again 1 year ago
docs work on docs, added 1 year ago
install corrected permissions again 1 year ago
onionr Improve logging, mostly 1 year ago
.dockerignore * cache pip requirements in dockerfile 2 years ago
.gitignore Add installation scripts 1 year ago
.gitlab-ci.yml changed to ubuntu in ci 1 year ago refactored onionr commands and other small adjustments 1 year ago * Progress in adjust tagline in files, license boilerplate fixes 1 year ago
Dockerfile Merge Tempblocks 1 year ago Create an issue template 2 years ago
LICENSE.txt do not spam connection messages 1 year ago
Makefile Add installation scripts 1 year ago
PKGBUILD Add installation scripts 1 year ago + added optimization check 1 year ago * phrase better 1 year ago Merge POM 1 year ago * bumped nacl and unpaddedbase32 verison 1 year ago
requirements.txt * bumped nacl and unpaddedbase32 verison 1 year ago
run-windows-dev.bat * more utils refactoring, requests this time 1 year ago
run-windows.bat windows color compat 1 year ago small fixes and work on tests 1 year ago Merge Tempblocks 1 year ago added announce node config 1 year ago

Private P2P Communication Network 🕵️

(pre-alpha & experimental, not well tested or easy to use yet)

Open Source Love - - .onion

The main repository for this software is at


Onionr is a decentralized, 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 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.

The whitepaper (subject to change prior to alpha release) is available here.

Tor stinks slide image

Main Features

Software Suite

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

Currently usable:

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

Not yet usable:

  • Instant messaging
  • Forum/BBS

Onionr API and functionality is subject to non-backwards compatible change during pre-alpha development


Node statistics page screenshot

Node statistics

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.6+, 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

(--require-hashes is intended to prevent exploitation via compromise of PyPi/CA certificates)

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)
    • General bug fixes and development of new features
  • Testing
  • UI/UX design
  • Running stable nodes
  • Security review/audit
  • Automatic I2P setup

Contribute money:

Donating at least $5 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


Email: beardog [ at ]


No matter how good Onionr and other software gets, there will always be ways for clever or well-funded adversaries to break your security.

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 ‘open source badge’ is by Maik Ellerbrock and is licensed under a Creative Commons Attribution 4.0 International License.

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.

node web illustration