decentragit is an open-source project built by Quorum Control which combines
the power of
git, the Tupelo DLT and Skynet from Sia.
decentragit uses decentralized ownership and storage to make it trivial to
create a decentralized, shareable git remote of your project.
decentragit accomplishes this without changing your GitHub workflow except that you can keep collaborating when it goes down.
With three simple steps you can create a decentralized mirror of your existing github project. All changes will be automatically propogated to the mirror version and the git services you depend on will be there when you need them.
A quick install using brew gets you started:
brew tap quorumcontrol/dgit && brew install dgit
Or if you don't have homebrew check out our simple manual installation instructions.
Next you will need to initialize each repo you want to make decentralized:
git dg init
This command does three things.
- decentragit sets the appropriate remote urls in your repo's .git/config file.
- decentragit creates a ChainTree which gets signed by the Tupelo DLT to specify ownership of the decentralized repo.
- decentragit stores that repo on Skynet, the decentralized storage solution from Sia.
From there you can proceed with normal git commands.
If you ever want to pull from the mirror you can specify the mirror with a "dg:".
As an example:
git clone dg://your_username/repo_name
If you want to keep your decentralized, shareable git remote in sync with your GitHub repo adding
a simple github action as illustrated in dgit-github-action is all it takes. Once completed your decentragit decentralized shareable remote will always be up to date and ready when you need it.
New Feature! DGit now allows you to publish your frontend files (html, css, js, .vue, .react) files to Skynet. Just checkout your files into a new branch named dg-pages, commit and push!
** NOTE: You need to have the Skynet CLI tool installed ** skynet-cli-repo
You can manage your repo's team of collaborators with the git dg team
command:
git dg team add [collaborator usernames]
git dg team list
git dg team remove [usernames]
Anyone on the team will be allowed to push to the repo in the current directory.
- Username can be set any of the following ways:
DG_USERNAME=[username]
env vargit config --global decentragit.username [username]
sets it in~/.gitconfig
git config decentragit.username [username]
sets it in./.git/config
You can find answers to some of the most frequently asked questions on the wiki.
- Clone this repo.
- Run
make
. Generates./git-dg
in top level dir.
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE
for more information.
If you have any questions or concerns please hop into our developer chat on gitter and we will be glad to help.
Project Link: https://github.com/quorumcontrol/dgit