Get Started

What is PPIO?

PPIO is a decentralized programmable storage and delivery network.

You can use PPIO to store and retrieve any amount of data at any time, from anywhere on the web. You can accomplish these tasks using the PPIO SDK or PPIO Command Line Interface (abbreviated as CLI in the following content).

PPIO is similar to the existing cloud-based storage services such as AWS S3 regarding usage and function. However, it is more robust, efficient and offers better privacy protection. It also reduces cost significantly. PPIO's well-designed blockchain-based incentives allow it to make use of the vast amount of unused bandwidth and storage resources on the Internet, and to provide robust storage service at much lower cost.

PPIO's unique decentralized file system prevents unauthorized access and ensures that all the data can be stored securely and privately.

PPIO is designed from the ground up to perform efficiently on a global scale, by leveraging the experience of the founding team - PPLabs. The team designed and ran decentralized network with experience of managing hundreds of millions of users before. PPIO meets the storage needs of both today's Internet businesses and services, and the emerging decentralized applications (DApps).

If you are interested in knowing why we want to design PPIO, check out the article Why Do We Want To Design PPIO?

Try PPIO CLI

The command of PPIO CLI starts with poss.

Step1: Prepare your PPIO wallet account

You must have a PPIO wallet account first. Because PPIO wallet account is your user credentials for using PPIO services.

You have to get keystore file and passphrase from your PPIO wallet account.

This is a guide to teach you how to generate a PPIO wallet account and get keystore file and passphrase from your PPIO wallet account. Also, you can get some test coins from this guide.

Step2: Install

  • Windows:
    Download the binary from here.

      poss.exe --help
    
  • macOS

      curl -o poss https://resource.testnet.pp.io/poss/release/macos/latest/poss
      chmod +x poss
      ./poss --help
    
  • Linux:

      curl -o poss https://resource.testnet.pp.io/poss/release/linux-amd64/latest/poss
      chmod +x poss
      ./poss --help
    

Step3: Import the user credentials to PPIO CLI and modify configuration file

  • macOS or Linux
    # import your wallet user credentials into PPIO CLI
    ./poss init --keystore=[your keystore file absolute path]
    
  • Windows
    # import your wallet user credentials into PPIO CLI
    poss.exe init --keystore=[your keystore file absolute path]
    

You can get keystore file from your PPIO wallet. This is the guide

Running the above command will generate some default configuration, some of which need to be modified.
Modify the contents of the ~/.poss/poss.conf file if you are using Mac OS or linux. Or modify the contents of the C:\Users\You Name\.poss\poss.conf file if you are using Windows.

 ...
 "TestNet": "test",
 ...
 ...
 "Bootstrap": [
    {
      "Name": "aws-bootstrap",
      "IP": "35.160.24.147",
      "UDPPort": 8020,
      "TCPPort": 8020,
      "HTTPPort": 0,
      "RPCPort": 0
    },
    {
      "Name": "ali-bootstrap",
      "IP": "47.110.88.167",
      "UDPPort": 8020,
      "TCPPort": 8020,
      "HTTPPort": 0,
      "RPCPort": 0
    }
  ],
  ...
  ...
  "Payment": {
   "Name": "default-payment",
   "IP": "indexrpc.testnet.pp.io",
   "UDPPort": 0,
   "TCPPort": 0,
   "HTTPPort": 18030,
   "RPCPort": 0
 },
 ...

Step4: Start PPIO service background

  • macOS or Linux
    # start the PPIO service background
    ./poss start --daemon --key-passphrase=[passphrase of your keystore]
    
  • Windows
    # start the PPIO service background
    poss.exe start --daemon --key-passphrase=[passphrase of your keystore]
    

You can get passphrase from your PPIO wallet. This is the guide

Step5: Upload and download a file using PPIO CLI

Run the following commands sequentially in your command line terminal.

  • macOS or Linux
    # create a bucket
    ./poss create-bucket --bucket=test
    
    # upload a file to PPIO
    ./poss put-object --bucket=test --chiprice=100 --key=/test  --expires=2019-04-01 --body=[your file absolute path]
    
    # get a file from PPIO
    ./poss get-object --bucket=test --key=/test --chiprice=100 --outfile=[Get file to local path]
    
  • Windows
    # create a bucket
    poss.exe create-bucket --bucket=test
    
    # upload a file to PPIO
    poss.exe put-object --bucket=test --chiprice=100 --key=/test  --expires=2019-04-01 --body=[your file absolute path]
    
    # get a file from PPIO
    poss.exe get-object --bucket=test --key=/test --chiprice=100 --outfile=[Get file to local path]
    

Well! Now you have completed the uploading and downloading of a file with PPIO. Of course, PPIO can do much more than that. Go to Command Line Interface Reference of PPIO

More Details

last modified: 1/29/2019, 11:16:24 AM