Skip to main content

Storage

Introduction​

This guide explains how Gitopia's decentralized storage system works, helping you understand the technology behind our platform and how to participate as a storage provider.

Gitopia uses a custom storage module in Gitopia blockhain and storage providers to create a robust, decentralized storage network for git repositories. This system ensures your code is always available, secure, and efficiently distributed across the network.

How It Works​

System Overview​

Our storage system is built on three key components working together to create a reliable and efficient storage solution. The Git Server handles all your git operations, making sure your code is properly stored and retrieved. The IPFS Cluster manages the distributed storage network, ensuring your data is replicated across multiple providers. Finally, the Blockchain Integration keeps track of repository packfiles,release assets and manages the rewards for storage providers.

Storage Architecture

Understanding the Data Flow​

When you push code to Gitopia, the system first processes your changes through the git server. This server creates a new packfile containing your changes and distributes it across the IPFS Cluster network. The blockchain is then updated with the new packfile information.

When you pull code, the system first checks if the data is available locally. If it's not found in the local cache, the system retrieves it from the IPFS Cluster network. This approach ensures fast access to frequently used data while maintaining the benefits of distributed storage.

Becoming a Storage Provider​

What You Need to Know​

To become a storage provider, you'll need to meet certain hardware and software requirements. These requirements ensure that you can effectively participate in the network and provide reliable storage services. For detailed setup instructions, please refer to our Storage Provider Guide.

As a storage provider, you'll participate in our verification system to ensure the reliability of the network. This system includes periodic challenges to verify that you're maintaining the data properly. Successful participation in this system comes with rewards, while missed challenges may result in penalties. Learn more about how the Storage Challenge System works and its economic incentives.