{"id":15285701,"url":"https://github.com/ibm/ipfsfb","last_synced_at":"2025-10-07T01:30:17.672Z","repository":{"id":57482652,"uuid":"166854527","full_name":"IBM/IPFSfB","owner":"IBM","description":"InterPlanetary File System for Business (IPFSfB) is an enterprise blockchain storage network based on InterPlanetary File System.","archived":true,"fork":false,"pushed_at":"2019-05-24T09:25:56.000Z","size":586,"stargazers_count":78,"open_issues_count":0,"forks_count":26,"subscribers_count":18,"default_branch":"master","last_synced_at":"2024-12-20T23:33:58.685Z","etag":null,"topics":["blockchain","cryptography","distributed-file-system","ipfs","networking","p2p","protocol"],"latest_commit_sha":null,"homepage":"https://developer.ibm.com/patterns/build-first-private-blockchain-network-interplanetary-file-system","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/IBM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-01-21T17:38:47.000Z","updated_at":"2024-11-11T20:11:46.000Z","dependencies_parsed_at":"2022-09-02T06:21:13.974Z","dependency_job_id":null,"html_url":"https://github.com/IBM/IPFSfB","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBM%2FIPFSfB","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBM%2FIPFSfB/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBM%2FIPFSfB/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/IBM%2FIPFSfB/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/IBM","download_url":"https://codeload.github.com/IBM/IPFSfB/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235569500,"owners_count":19011184,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["blockchain","cryptography","distributed-file-system","ipfs","networking","p2p","protocol"],"created_at":"2024-09-30T15:07:13.150Z","updated_at":"2025-10-07T01:30:17.288Z","avatar_url":"https://github.com/IBM.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# InterPlanetary File System for Business (IPFSfB)\n\n[![Build Status](https://api.travis-ci.org/IBM/IPFSfB.svg?branch=master)](https://travis-ci.org/IBM/IPFSfB)\n\nThis repository contains instructions to build a private, unstructured data storage network for any blockchain on distributed file system, InterPlanetary File System for Business (IPFSfB), using crypto tools and Docker images with Docker and Docker Compose to provision the enterprise blockchain storage network.\n\n## Overview\n\nInterPlanetary File System for Business (IPFSfB) is based on InterPlanetary File System, which aim to provide an enterprise form, unstructured data storage network for any blockchain.\n\n## Flow\n\nCurrently we have two flows for each contributors and users.\n\n### Flow 1: for contributors\n\n![IPFSfB Contributor Flow](docs/flow/flow-v1-contributor.png)\n\nThe contributor flow tells you how to contribute to IPFSfB. You can also refer to the [contributors guide](CONTRIBUTING.md).\n\n### Flow 2: for users\n\n![IPFSfB User Flow](docs/flow/flow-v3-user.png)\n\nThe user flow corresponds how to set up a private network, which you can refer to [running a private network](#1-running-a-private-network).\n\n## Prerequisites\n\n- [Docker](https://www.docker.com/)\n- [Go](https://golang.org/)\n- [Git](https://git-scm.com/)\n\n## Building from source\n\nBuilding from source with IPFSfB repository:\n\n``` bash\ngo get -u github.com/IBM/IPFSfB\n```\n\nBuilding from source with IPFSfB tools, once the repository is downloaded, run:\n\n``` bash\nmake swarmkeygen\n```\n\nor build all utilities:\n\n``` bash\nmake all\n```\n\n## Steps\n\n1. [Running a private network](#1-running-a-private-network)\n2. [Runtime instructions](#2-runtime-instructions)\n3. [Scenarios](#3-scenarios)\n4. [Considerations](#4-considerations)\n5. [Architecture](#5-architecture)\n6. [Troubleshooting](#6-troubleshooting)\n7. [Related links](#7-related-links)\n8. [License](#8-license)\n\n## 1. Running a private network\n\nCurrently, we are offering simple network as one of the samples. It contains three senarios including peer-to-peer, peer-to-server, and peer to peer and to server. You can follow the [tutorial](docs/tutorial/simple-network.md) to envision and run a private network.\n\n## 2. Runtime instructions\n\nIf you are running a private network, [config.sh](samples/simple-network/config.sh) file will help containers to check runtime health. Regularly inspect docker containers log in the runtime environment may be helpful.\n\n## 3. Scenarios\n\nOne of the samples, simple network is avaliable in three scenarios ([p2p](https://en.wikipedia.org/wiki/Peer-to-peer), [p2s](https://zh.wikipedia.org/wiki/P2S), and [p2sp](https://zh.wikipedia.org/wiki/P2SP)).\n\nThe scenario guidelines are available at [docs/tutorial/simple-network.md](docs/tutorial/simple-network.md).\n\n### Accessing and running\n\nYou can access and download network specific binaries and images through [bootstrap.sh](samples/simple-network/scripts/bootstrap.sh). Once downloaded, you can run these network scenarios by [pnet.sh](samples/simple-network/pnet.sh).\n\n### End-to-end testing\n\nEach scenarios have end-to-end testing, located in [samples/simple-network/e2e](samples/simple-network/e2e).\n\n## 4. Considerations\n\nThere are several considerations for the roadmap of IPFSfB.\n\n### Performance and production\n\nFor the private or enterprise network performance, such as uploading a file, downloading a file, hosting a web, and even collaborating a documentation from the network, we need more network connection cases and speed performance to test the network.\n\nIPFSfB production will not only include simple network scenarios for private network, but also give a vision for clustering, consensus enabled enterprise network.\n\n### Extension\n\n- General data interface for any blockchain\n- VS Code extension\n- Hyperledger Fabric extension\n\n## 5. Architecture\n\nWe have made a document references for the architecture diagrams.\nYou can refer to the [architecture](docs/arch/architecture-references.md) document for the architecture of each scenarios.\n\n## 6. Troubleshooting\n\nIf you have encountered a problem for running IPFSfB, raise an issue and mention one of the maintainers in the [maintainers board](MAINTAINERS.md#maintainers-board).\n\n## 7. Related links\n\n- [go-ipfs](https://github.com/ipfs/go-ipfs): this repository is based on InterPlanetary File System implementation in Go.\n- [Hyperledger Fabric - Building Your First Network](https://hyperledger-fabric.readthedocs.io/en/master/build_network.html): the technical design of each scenarios of simple network are referenced to build your first network (BYFN) sample.\n\n## 8. License\n\nThis code pattern is licensed under the Apache Software License, Version 2. Separate third-party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the [Developer Certificate of Origin, Version 1.1 (DCO)](https://developercertificate.org/) and the [Apache Software License, Version 2](https://www.apache.org/licenses/LICENSE-2.0.txt).\n\n[Apache Software License (ASL) FAQ](https://www.apache.org/foundation/license-faq.html#WhatDoesItMEAN)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibm%2Fipfsfb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibm%2Fipfsfb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibm%2Fipfsfb/lists"}