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 234f1eed0c
undo what I did
2 years ago
docs Add onionr icon 2 years ago
install Fix bugs in release creation script 2 years ago
onionr undo what I did 2 years ago
.dockerignore * cache pip requirements in dockerfile 3 years ago
.gitignore Add log files to gitignore 2 years ago
.gitlab-ci.yml changed to ubuntu in ci 2 years ago work on contact manager, removed old twitter-like ui for now 2 years ago Merge POM 2 years ago
Dockerfile Merge Tempblocks 2 years ago Create an issue template 3 years ago
LICENSE.txt do not spam connection messages 2 years ago
Makefile Fix potential future bug with Makefile 2 years ago
PKGBUILD Correct PKGBUILD's version info 2 years ago do not spam connection messages 2 years ago Merge POM 2 years ago more refactoring and secured requirements.txt 2 years ago
requirements.txt more refactoring and secured requirements.txt 2 years ago
run-windows.bat windows color compat 2 years ago small fixes and work on tests 2 years ago Merge Tempblocks 2 years ago Merge POM 2 years ago

Anonymous P2P storage network 🕵️

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

Open Source Love

The main repository for this software is at


Onionr is a decentralized, peer-to-peer data storage network, designed to be anonymous and resistant to (meta)data analysis and spam/disruption.

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 particular nodes (only inferred). Even if there is enough evidence to believe a particular node created a block, nodes still operate behind Tor or I2P and as such are not trivially known to be at a particular IP address.

Users are identified by ed25519 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.

Tor stinks slide image

Main Features

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.

Install and Run on Linux

The following applies to Ubuntu Bionic. Other distros may have different package or command names.

  • Have python3.6+, python3-pip, Tor (daemon, not browser) installed (python3-dev 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 help out. 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 privacy coins like Monero)

USD (Card/Paypal): Ko-Fi

Note: probably not tax deductible


beardog [ at ]


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 our logo in a way that makes it seem like we endorse you without permission.