BitDust project source codes development cycle, official Development Git repository (mirror on GitHub) : https://bitdust.io
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
CodernityDB few more py3 fixes Oct 10, 2018
CodernityDB3 backup_fs fixes Nov 3, 2018
access fixing file sharing, clean up Dec 2, 2018
automats few more py3 fixes Dec 7, 2018
blockchain added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
broadcast packet.Payload needs to be translated to text in some cases Oct 26, 2018
chat added ssh tunnels to regression tests, use settings.getPrivateKeySize… Dec 4, 2018
coins added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
contacts few more py3 fixes Dec 7, 2018
crypt bug fixes in family_member, improved packet in/out logging Dec 1, 2018
currency added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
customer reduce logs Dec 8, 2018
deploy removed parallelp lib from the repo Dec 7, 2018
dht reduce logs Dec 8, 2018
icons working on taskbar icon Dec 17, 2015
interface added ssh tunnels to regression tests, use settings.getPrivateKeySize… Dec 4, 2018
lib added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
logs added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
main reduce logs Dec 8, 2018
p2p reduce logs Dec 8, 2018
raid reduce logs Dec 8, 2018
regression modified: regression/docker-compose.yml Dec 10, 2018
release removed parallelp lib from the repo Dec 7, 2018
requirements Introduced requirements for tests environment Oct 26, 2018
scripts cleanup in tests/ folder, added "make test" command to execute all un… Oct 20, 2018
services added ssh tunnels to regression tests, use settings.getPrivateKeySize… Dec 4, 2018
storage added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
stun added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
supplier fixing file sharing, clean up Dec 2, 2018
system reduce logs Dec 8, 2018
tests test_file_upload_download should pass now Dec 10, 2018
transport state machine core event() method will properly trigger state changed… Dec 2, 2018
updates added # @UnresolvedImport in many places to silence PyDev warnings Nov 22, 2018
userid good progress with service_customer_family() Nov 29, 2018
.dockerignore Introduced requirements for tests environment Oct 26, 2018
.editorconfig Introduced requirements for tests environment Oct 26, 2018
.gitignore "make test" command will also execute "python bitdust.py install" first Oct 20, 2018
.travis.yml fixed ./regression tests Nov 19, 2018
CHANGELOG.txt updated CHANGELOG, prepare next release Nov 10, 2018
LICENSE.txt publish Python sources under GNU AGPLv3 Sep 17, 2016
MANIFEST.in 07.07.2014 at 15:02:52 Jul 7, 2014
Makefile make test_regression Nov 18, 2018
README.md building healt_check() method for every network service Nov 16, 2018
README.txt added more logs, last tests Sep 21, 2018
__init__.py updated copyright string and modified "http://bitdust.io" into "https… Dec 2, 2017
bitdust.py py3 import fixes Sep 7, 2018
bpcmd.py py3 import fixes Sep 7, 2018
bppipe.py py3 import fixes Sep 7, 2018
bptester.py py3 import fixes Sep 7, 2018
compile.py Speed up raid commands Sep 28, 2018
history modified: history Nov 10, 2018
manage.py executed "python-modernize -w -n *" Sep 7, 2018
requirements.txt Introduced requirements for tests environment Oct 26, 2018
setup.cfg added few options in services/identity-propagate/ branch, updated id_… Nov 23, 2017
setup.py removed parallelp lib from the repo Dec 7, 2018
setup_gen.py updated CHANGELOG, prepare next release Nov 10, 2018

README.md

BitDust

bitdust.io

Build Status

About

BitDust is a peer-to-peer online backup utility.

This is a distributed network for backup data storage. Each participant of the network provides a portion of his hard drive for other users. In exchange, he is able to store his data on other peers.

The redundancy in backup makes it so if someone loses your data, you can rebuild what was lost and give it to someone else to hold. And all of this happens without you having to do a thing - the software keeps your data in safe.

All your data is encrypted before it leaves your computer with a private key your computer generates. No one else can read your data, even BitDust Team! Recover data is only one way - download the necessary pieces from computers of other peers and decrypt them with your private key.

BitDust is written in Python using pure Twisted framework and published under GNU AGPLv3.

Current status

Current project stage is about to only research opportunities of building a holistic eco-system that protects your privacy in the network by establishing p2p communications of users and maximize distribution of information flows in the network.

At the moment exists a very limited alpha version of the BitDust software. We decided to publish those earlier works to verify/test/share our ideas and experiments with other people.

Install BitDust software

Install software dependencies

Seems like in Ubuntu (probably most other distros) you can install all dependencies in that way:

    sudo apt-get install git gcc python-dev python-virtualenv

Optionally, you can also install miniupnpc tool if you want BitDust automatically deal with UPnPc configuration of your network router so it can also accept incomming connections from other nodes.:

    sudo apt-get install miniupnpc

On MacOSX platform you can install requirements in that way:

    brew install git python2

And use pip to get all required packages:

    pip install --upgrade --user
    pip install --upgrade pip --user
    pip install virtualenv --user

On Raspberry PI you will need to install those packages:

    sudo apt-get install git gcc python-dev python-virtualenv libffi-dev libssl-dev

Get BitDust to your local machine

Second step is to get the BitDust sources. To have a full control over BitDust process running on your local machine you better make a fork of the Public BitDist repository on GitHub at https://github.com/bitdust-io/public and clone it on your local machine:

    git clone https://github.com/<your GitHub username>/<name of BitDust fork>.git bitdust

The software will periodically run git fetch and git rebase to check for recent commits in the repo. This way we make sure that everyone is running the latest version of the program. Once you made a fork, you will have to update your Fork manually and pull commits from Public BitDust repository if you trust them.

However if you just trust BitDust contributors you can simply clone the Public repository directly and software will be up to date with the "official" public code base:

    git clone https://github.com/bitdust-io/public.git bitdust

Building virtual environment

Then you need to build virtual environment with all required Python dependencies, BitDust software will run fully isolated.

Single command should make it for you, all required files will be generated in ~/.bitdust/venv/ sub-folder:

    cd bitdust
    python bitdust.py install

Last step to make BitDust software ready is to make a short alias in your OS, then you can just type bitdust in command line to fast access the program:

    sudo ln -s -f /home/<user>/.bitdust/bitdust /usr/local/bin/bitdust

Run BitDust

Start using the software by creating an identity for your device in BitDust network:

    bitdust id create <some nick name>

I recommend you to create another copy of your Private Key in a safe place to be able to recover your data in the future. You can do it with such command:

    bitdust key copy <nickname>.bitdust.key

Your settings and local files are located in that folder: ~/.bitdust

Type this command to read more info about BitDust commands:

    bitdust help

To run the software just type:

    bitdust

Start as background process:

    bitdust daemon

To get some more insights or just to know how to start playing with software you can visit BitDust Commands page.

To get more info about API methods available go to BitDust API page.

Binary Dependencies

If you are installing BitDust on Windows platforms, you may require some binary packages already compiled and packaged for Microsoft Windows platforms, you can check following locations and download needed binaries and libraries:

Feedback

You can contact BitDust contributors on GitHub if you have any questions or ideas. Welcome to the future!