BitDust
=======
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.
https://bitdust.io
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
========================
1. 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 python3-dev python3-virtualenv
Optionally, you can also install [miniupnpc](http://miniupnp.tuxfamily.org/) 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 python3
And use pip to get all required packages:
pip install --upgrade --user
pip install --upgrade pip --user
pip install virtualenv --user
2. 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
3. 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
python3 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
4. 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 type:
bitdust
Start as background process:
bitdust detach
To get some more insights or just to know how to start playing with software
you can visit [BitDust Commands](https://bitdust.io/commands.html) page.
To get more info about API methods available go to [BitDust API](https://bitdust.io/api.html) page.
5. 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:
* cygwin: [cygwin.com](https://cygwin.com/install.html)
* git: [git-scm.com](https://git-scm.com/download/win)
* python2.7 or python3: [python.org](http://python.org/download/releases)
* twisted: [twistedmatrix.com](http://twistedmatrix.com)
* pyasn1: [pyasn1.sourceforge.net](http://pyasn1.sourceforge.net)
* miniupnpc: [miniupnp.tuxfamily.org](http://miniupnp.tuxfamily.org/)
Docker Hub container image
==========================
You can also run bitdust inside Docker. We prepared a container which have BitDust installed and easy to run. You will have to SSH into the running container after start it and manually configure bitdust as you wish and run it:
docker run -d -P --name bdnode bitdust/app1
docker port bdnode 22
0.0.0.0:32771 <- learn which SSH port was opened on your host
Now you can ssh to the container, password is `bitdust`:
ssh root@localhost -p 32771
password: bitdust
Inside the container you will have BitDust installed and ready to use, so you can run it directly:
root@1ef6a46c3042:~# bitdust
Feedback
========
You can contact [BitDust contributors](https://github.com/bitdust-io) on GitHub if you have any questions or ideas.
Welcome to the future!
Raw data
{
"_id": null,
"home_page": "https://bitdust.io",
"name": "bitdust",
"maintainer": "Veselin Penev, BitDust",
"docs_url": null,
"requires_python": "",
"maintainer_email": "veselin@bitdust.io",
"keywords": "p2p,peer to peer,backup,restore,storage,data,recover,distributed,online,python,twisted,messaging,websocket,encryption,crypto,protection",
"author": "Veselin Penev, BitDust",
"author_email": "bitdust.io@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/08/3e/89cc5945e31bfff70239ee0aa082f8064cdd66457c649eaae712882ee879/bitdust-0.1.8.234.tar.gz",
"platform": null,
"description": "BitDust\n=======\n\nBitDust is a peer to peer online backup utility.\n\nThis 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.\n\nThe 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.\n\nAll 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.\n\nBitDust is written in Python using pure Twisted framework and published under GNU AGPLv3.\n\nhttps://bitdust.io\n\n\n\nCurrent status\n==============\n\nCurrent project stage is about to only research opportunities of\nbuilding a holistic eco-system that protects your privacy in the network\nby establishing p2p communications of users and maximize distribution of\ninformation flows in the network.\n\nAt the moment exists a very limited alpha version of the BitDust software.\nWe decided to publish those earlier works to verify/test/share our ideas and experiments with other people.\n\n\n\nInstall BitDust software\n========================\n\n\n1. Install software dependencies\n\nSeems like in Ubuntu (probably most other distros) you can install all dependencies in that way:\n\n sudo apt-get install git gcc python3-dev python3-virtualenv\n\n\nOptionally, you can also install [miniupnpc](http://miniupnp.tuxfamily.org/) tool if you want BitDust automatically deal with UPnPc configuration of your network router so it can also accept incomming connections from other nodes.:\n\n sudo apt-get install miniupnpc\n\n\nOn MacOSX platform you can install requirements in that way:\n\n brew install git python3\n\nAnd use pip to get all required packages:\n\n pip install --upgrade --user\n pip install --upgrade pip --user\n pip install virtualenv --user\n\n\n2. Get BitDust to your local machine\n\nSecond 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:\n\n git clone https://github.com/<your GitHub username>/<name of BitDust fork>.git bitdust\n\n\nThe 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.\n\nHowever 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:\n\n git clone https://github.com/bitdust-io/public.git bitdust\n\n\n3. Building virtual environment\n\nThen you need to build virtual environment with all required Python dependencies, BitDust software will run fully isolated.\n\nSingle command should make it for you, all required files will be generated in `~/.bitdust/venv/` sub-folder:\n\n cd bitdust\n python3 bitdust.py install\n\n\nLast 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:\n\n sudo ln -s -f /home/<user>/.bitdust/bitdust /usr/local/bin/bitdust\n\n\n4. Run BitDust\n\nStart using the software by creating an identity for your device in BitDust network:\n\n bitdust id create <some nick name>\n\n\nI 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:\n\n bitdust key copy <nickname>.bitdust.key\n\n\nYour settings and local files are located in that folder: ~/.bitdust\n\nType this command to read more info about BitDust commands:\n\n bitdust help\n\n\nTo run the software type:\n\n bitdust\n\n\nStart as background process:\n\n bitdust detach\n\n\nTo get some more insights or just to know how to start playing with software\nyou can visit [BitDust Commands](https://bitdust.io/commands.html) page.\n\nTo get more info about API methods available go to [BitDust API](https://bitdust.io/api.html) page.\n\n\n5. Binary Dependencies\n\nIf 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:\n\n* cygwin: [cygwin.com](https://cygwin.com/install.html)\n* git: [git-scm.com](https://git-scm.com/download/win)\n* python2.7 or python3: [python.org](http://python.org/download/releases)\n* twisted: [twistedmatrix.com](http://twistedmatrix.com)\n* pyasn1: [pyasn1.sourceforge.net](http://pyasn1.sourceforge.net)\n* miniupnpc: [miniupnp.tuxfamily.org](http://miniupnp.tuxfamily.org/)\n\n\n\nDocker Hub container image\n==========================\n\nYou can also run bitdust inside Docker. We prepared a container which have BitDust installed and easy to run. You will have to SSH into the running container after start it and manually configure bitdust as you wish and run it:\n\n docker run -d -P --name bdnode bitdust/app1\n docker port bdnode 22\n 0.0.0.0:32771 <- learn which SSH port was opened on your host\n\n\nNow you can ssh to the container, password is `bitdust`:\n\n ssh root@localhost -p 32771\n password: bitdust\n\n\nInside the container you will have BitDust installed and ready to use, so you can run it directly:\n\n root@1ef6a46c3042:~# bitdust\n\n\n\nFeedback\n========\n\nYou can contact [BitDust contributors](https://github.com/bitdust-io) on GitHub if you have any questions or ideas.\nWelcome to the future!\n",
"bugtrack_url": null,
"license": "Copyright (C) 2008 Veselin Penev, https://bitdust.io",
"summary": "p2p secure distributed storage and communication engine",
"version": "0.1.8.234",
"split_keywords": [
"p2p",
"peer to peer",
"backup",
"restore",
"storage",
"data",
"recover",
"distributed",
"online",
"python",
"twisted",
"messaging",
"websocket",
"encryption",
"crypto",
"protection"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "083e89cc5945e31bfff70239ee0aa082f8064cdd66457c649eaae712882ee879",
"md5": "11520e1daa9374befd5e05aae789ab03",
"sha256": "bdcf24b3178a430decaaaaeafd998827eb186c7b960dc3275f4e4510023dd1a5"
},
"downloads": -1,
"filename": "bitdust-0.1.8.234.tar.gz",
"has_sig": false,
"md5_digest": "11520e1daa9374befd5e05aae789ab03",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 1074268,
"upload_time": "2023-04-22T20:43:21",
"upload_time_iso_8601": "2023-04-22T20:43:21.149030Z",
"url": "https://files.pythonhosted.org/packages/08/3e/89cc5945e31bfff70239ee0aa082f8064cdd66457c649eaae712882ee879/bitdust-0.1.8.234.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-04-22 20:43:21",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "bitdust"
}
JSON