# Hosted Powergate
Powergate is a multitiered storage solution that stores data with IPFS ("Hot" storage layer) and Filecoin ("Cold" storage layer). Hosted Powergate instances are available for builders upon request.
This guide will help you get started with Hosted Powergate. We will be using the Powergate CLI to interact with the Powergate API endpoint.
Sign-up for a hosted Powergate instance:
Complete the form at https://blog.textile.io/hosted-powergate/ (opens new window). When your application is approved, you will receive an email with connection instructions and an assigned API endpoint.
Download and install
powCLI tool (opens new window) will help us interact with the Powergate instance. It can be installed with:
git clone https://github.com/textileio/powergate cd powergate make install-pow
Set up your remote API endpoint:
The endpoint is provided in the welcome email. To let
# Use your provided endpoint export POW_SERVERADDRESS=api.pow.something.textile.io:443 # Verify it works pow version
Create a new User instance:
A User instance manages all the necessary state and capabilities to provide multitiered file storage through the Powergate. Each Powergate setup can manage an arbitrary number of User instances. To create a new User:
pow admin user create
This will print an instance ID and a User auth token. Write down the token as we will need it for every other User operation. As an optional convienience (vs. including the User
--tokenflag on every
powcommand), you can let Powergate know about it with the
The hosted Powergate instance is automatically configured to add small funding into every User instance you create. You can repeat the
createstep multiple times if you need multiple User instances with different configurations, but you will need to use the
--tokenflag so that Powergate knows which User instance to interact with. You can check the default configuration (opens new window) for storage jobs within a User instance:
pow config default -t [User auth token]
Additional details about User instances can be found in the official documentation (opens new window).
Stage your data:
Unless your data is already available on IPFS (in which case you can skip this step), you can use Powergate to import your data using the
pow data stage [path|url]
Note the CID in the output. This will be used to initiate the Powergate storage.
Initiate data storage:
The following command pushes a new storage configuration for a CID, creates a storage job for it, and watches the progress of the resulting job:
pow config apply [cid] --watch
The configuration used will be based on the default configuration unless a custom configuration is provided (see
pow config apply --help). Powergate will automatically find miners and perform the storage deal.
You can watch the job progress anytime with:
pow storage-jobs watch [jobid]
For additional details and up-to-date information on how to use
powand perform other operations like retrieval, see the official Textile docs (opens new window).
Interact with the Powergate API:
Additional resources, including videos and examples using Powergate are available from our dedicated page.