Steps to Install git-remote-gitopia(Linux/macOS)
Run the following command in your terminal.
curl https://get.gitopia.com | bash
If you get the following error
mv: rename ./git-remote-gitopia to /usr/local/bin/git-remote-gitopia: Permission denied
============
Error: mv failed
You would need root permission to move the binary to /usr/local/bin
sudo mv /tmp/tmpinstalldir/git-remote-gitopia /usr/local/bin/
Usage of git-remote-gitopia
git-remote-gitopia will be implicitly called when git encounters gitopia:// remote.
For pushing git repositories to Gitopia, you would require a Gitopia wallet with sufficient tokens and you need to configure the wallet for git-remote-gitopia. git-remote-gitopia currently supports the following wallets.
We recommend that you keep a separate wallet, added as a collaborator, for authorizing wallet and pushing your code. Don't use your main wallet and keep it safe.
OS Keyring (Recommended)
The OS keyring uses the native operative system's keyring to store the keys securely. This is the recommended way to store your Gitopia keys. Follow the steps here to use OS Keyring to push your commits to Gitopia.
Gitopia Wallet
You can download the Gitopia wallet from the webapp. Set an environment variable GITOPIA_WALLET with the path of your wallet file. Follow the steps here to set up a Gitopia wallet to push your commits to Gitopia.
Ledger Hardware Wallet
git-remote-gitopia also supports Ledger Hardware Wallet. Follow the steps here to install the Cosmos (ATOM) app. Connect your ledger and open the Cosmos (ATOM) when you git push.
You will get prompted to sign the transaction two times. The first transaction is for generating offchain signature to authenticate with git server, this transaction is not broadcasted to the chain and is not a valid chain transaction. The second transaction is the actual transaction to update the repository state on the Gitopia chain.
Keep your wallet file secure and do not share it with anyone.