Latest documentation is available at https://docs.fairos.fairdatasociety.org/docs/

The Decentralised File System (dfs) is a file system built for the FairOS. It is a stateless thin layer which uses the building blocks provided by Swarm to provide high level functionalities like

• Exposing a logical file system
• Creation of logical drives
• User and Permission management
• Charging and Payments
• Mutable, Indexed data structures over immmutable file system

dfs can be used for the following use cases

1. Personal data store
2. Application data store (for both Web 3.0 DApps and web 2.0 Apps)
3. Data sharing with single user and on an organizational level

The first step in dfs is to create a user. Every user is associated with a 12 word mnemonic based hd wallet. This wallet is password protected and stored in the datadir. whenever a user created a pod for himself, a new key pair is created using this mnemonic. A user can use this mnemonic and import their account in any device and instantly see all their pods.

A pod is a personal drive created by a user in fairOS-dfs. It is used to store files and related metadata in a decentralised fashion. A pod is always under the control of the user who created it. A user can create and store any number of files or directories in a pod. The user can share files in his pod with any other user just like in other centralised drives like dropbox. Not only users, a pod can be used by decentralised applications (DApp's) to store data related to that user.

Pod creation is cheap. A user can create multiple pods and use it to organise his data. for ex: Personal-Pod, Applications-Pod etc.

Run the following command to download the latest release

curl -o- https://raw.githubusercontent.com/fairDataSociety/fairOS-dfs/master/download.sh | bash

wget -qO- https://raw.githubusercontent.com/fairDataSociety/fairOS-dfs/master/download.sh | bash

Or download the latest release from https://github.com/fairDataSociety/fairOS-dfs/releases.

Or use Docker to run the project https://docs.fairos.fairdatasociety.org/docs/fairOS-dfs/docker-installation.

Or build the latest version with the instruction https://docs.fairos.fairdatasociety.org/docs/fairOS-dfs/manual-installation.

To get the most out of your FairOS-dfs it is important that you configure FairOS-dfs for your specific use case!

bee:
  bee-api-endpoint: http://localhost:1633
  bee-debug-api-endpoint: http://localhost:1635
  postage-batch-id: ""

dfs:
  data-dir: /Users/fairos/.fairOS/dfs
  ports:
    http-port: :9090
    pprof-port: :9091

cookie-domain: api.fairos.io
cors-allowed-origins: []
verbosity: trace

Run dfs config to see all configurations

https://docs.fairos.fairdatasociety.org/docs/fairOS-dfs/api-reference

https://docs.fairos.fairdatasociety.org/docs/fairOS-dfs/cli-reference

To make binaries for all platforms run this command

./generate-exe.sh