Skip to main content

Steps to Install git-remote-gitopia(Linux/macOS)

Run the following command in your terminal.

curl | 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.

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.