Main BitDust web site files : 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.
automats
chat
conf
css
customer
fancybox
fonts
images
js
lib
main
p2p
pics
raid
services
share_buttons
storage
stun
supplier
transport
userid
video
.gitignore
LICENSE
Makefile
README.html
README.md
api.html
automat_backup.html
automat_backup_db_keeper.html
automat_backup_monitor.html
automat_backup_rebuilder.html
automat_contact_status.html
automat_customers_rejector.html
automat_data_sender.html
automat_fire_hire.html
automat_id_registrator.html
automat_id_restorer.html
automat_id_server.html
automat_initializer.html
automat_install_wizard.html
automat_installer.html
automat_list_files_orator.html
automat_local_service.html
automat_network_connector.html
automat_network_transport.html
automat_nickname_holder.html
automat_nickname_observer.html
automat_p2p_connector.html
automat_packet_in.html
automat_packet_out.html
automat_proxy_receiver.html
automat_proxy_router.html
automat_proxy_sender.html
automat_raid_worker.html
automat_restore.html
automat_shutdowner.html
automat_stun_client.html
automat_stun_server.html
automat_supplier_connector.html
automat_supplier_finder.html
automat_tcp_connection.html
automat_udp_connector.html
automat_udp_node.html
automat_udp_session.html
automat_udp_stream.html
automats.html
bitdust128.png
bitdust256.png
bitdust_services_tree.pdf
bugs.html
build
build.bat
build_visual
buildone
changelog.html
commands.html
concept.html
corporate.html
crypto_contracts.html
definitions.html
deploy
dht.html
donate.html
download.html
dustalk_messanger.html
economy.html
favicon.ico
feedback.php
fix_html.py
givejob.html
glossary.html
identities.html
identity_server.html
immutable_history.html
index.html
install.html
intro.html
keywords.txt
kw.txt
make.bat
md2html.py
monetization.html
news.html
pack.bat
philosophy.html
poker.html
principle.html
pull
pull.bat
push
push.bat
rebuilding.html
respect.html
roadmap.html
robots.txt
run_server.bat
screenshots.html
security.html
services.html
settings.html
sharing.html
sitemap.xml
software_releases.html
storage.html
technologies.html
template.htm
toc.html
transports.html
update
update.bat
visuals.bat

README.md

BitDust

About

BitDust - is decentralized, secure and anonymous on-line storage, where only the owner has access and absolute control over its data.

Imagine a situation when two friends and you agree to help each other to store the data. On your computer you store the data that both of your friends uploaded to you via Internet, and you in turn can use the free space on their machines to save your files. This creates redundancy, but allows storing important data in a safer way. It is also a fair deal, because all three are interested in the maximum safety and availability of stored information.

BitDust network is a voluntary association of people sharing resources of their personal computers. Their machines run the same copies of BitDust program, which enables device communication via Internet when data are transmitted directly from one user to another and stored on user hard disk drives.

Uploaded input data is divided into blocks and fragments, encrypted and uploaded on other users computers. The system is designed to perform continuous monitoring of each node, which stores your data.

The BitDust program constantly keeps a state, which enables you to download your data back to your machine at any moment. The mechanism of automatic data restoring allows dynamic reassembling of the data fragments uploaded into the network on the new nodes without any action from the user.

BitDust program is written in Python using Twisted Framework and is distributed in open source code - we are still deciding about the license type.

The project is in the stage of deep development, but the demo version will be available in the near future.

We invite all who are interested in this direction - primarily developers and enthusiasts. Join our team, or directly support us. Together we will be able to create a fairer alternative and trusted solutions than existing global networks.

Beginning

Working Principles

Development

Deploying

You can just open "index.html" file in the root folder of your local "www" repository and fully automated and independent copy of the web site will be rendered in your web browser. The web site do not require database to be avaialble on your host and only serve static HTML pages at the moment.

On the live machine serving https://bitdust.io resource "www" repository is cloned and direcly loaded into WWW folder maintained by Apache2 web server. When your "Pull Request" will be merged we will execute "./update" caommand to pull changes on the live machine.

Contributing

This repository contains .html files generated from BitDust documentation sources built in Markdown format. If you want to modify any page on the web site, create a fork of both repositories on GitHub and clone it locally:

git clone git@github.com:<your github username>/docs.git bitdust.docs
cd bitdust.docs
git remote add upstream https://github.com/bitdust-io/docs.git

You also need to have bitdust.devel repository cloned in the parent folder, because some of Markdown pages are generated from BitDust Python sources. So Makefile expects ../bitdust.devel folder to be already existed:

cd ..
git clone https://github.com/bitdust-io/devel.git bitdust.devel

Next make a fork and clone BitDust web site repository:

git clone git@github.com:<your github username>/www.git bitdust.www
cd bitdust.www
git remote add upstream https://github.com/bitdust-io/www.git

Also please be sure you have markdown2 package installed globally:

sudo apt-get install python-pip
pip install markdown2

Now you can start making changes in .md files of your local "bitdust.docs" repo. Save modified .md file and run make html in "bitdust.www" repo - a new .html file will be generated with fresh changes you just did in the corresponding .md file.

Then you can re-generate the whole BitDust web site locally that way:

cd ../bitdust.docs
make build
cd ../bitdust.www
make html

To put your changes in live you need to make two Pull Requests: first to bitdust.docs repo and second to bitdust.www repo. Commit and push your git changes to your bitdust.docs fork repository and start a Pull Request:

cd ../bitdust.docs
make build
git add -u -v
git commit -m "some comment to describe what you did"
git push origin master

Do the same for bitdust.www repository and start a second Pull Request:

cd ../bitdust.www
make html
git add -u -v
git commit -m "some comment to describe what you did"
git push origin master

After your changes got merged you need to pull latest changes from upstream and push to your fork:

git pull upstream master
git push orgigin master

BitDust team is doing public code reviews and we will be in touch with you to go further. If you like the project, join BitDust contributors on GitHub.

bitdust.io