How to Upload to ethoFS

This guide will show you 2 ways of using ethoFS based on the version of MetaMask you'd like to use.


In order to upload data to ethoFS you need a browser with MetaMask or preferably the Ether-1 version of the same. While the former method is faster to get running, we recommend the latter for the full Ether-1 & ethoFS experience. With the stock MetaMask version you will see ETH instead of ETHO being listed in the app, which is confusing to some of our users.

MetaMask allows your browser to user your Ether-1 wallet in order to sign smart contracts and perform ETHO transactions. Your ethoFS upload is bound to your ETHO address so that you and only you can take down your data.

The Ether-1 team recommends installing the Ether-1 version of MetaMask for the best ethoFS experience. (If you have the current version of MetaMask installed and you use it, we suggest installing the Ether-1 version on a secondary browser.)

Installing Ether-1 MetaMask (Recommended)

The Ether-1 team have produced a custom version of MetaMask for use with ethoFS and the Ether-1 ecosystem. Currently this extension is only available on the chrome app store, while a Firefox and Edge version are available for manual instal, pending addition to the appropriate stores. (If you want the package for manual install you can request it through our discord server.)

You can find the Chrome application here:

  1. You will be prompted to accept the terms and conditions, privacy policy and phishing warning:

  2. You will be then prompted to create a new MetaMask wallet by creating a secure password. (You can also import an existing account):

  3. You will then be prompted to backup your recovery phrase, this is used to recover your account, so it is important to store it somewhere safe:

  4. You now have setup the Ether-1 version of MetaMask and have created a wallet ready to use with ethoFS!

Installing Stock MetaMask (faster)

To use MetaMask with ethoFS you can install a browser extension from the appropriate app store for your particular browser. For this example, we will be using the chrome version. You can find the chrome application here:

Chrome App Store - MetaMask

After Installing the MetaMask browser extension, you will need to go through the following setup process:

  1. When prompted, press continue.

  2. Create a strong password to use with MetaMask. (You can also import an existing wallet with the seed phrase, to restore an existing account.)

  3. After creating a password, you will be shown your account image, and then you will be prompted to accept the MetaMask Terms & Conditions along with a privacy notice and a statement on phishing.

  4. Following acceptance of all the various terms, you will be prompted to backup your recovery seed. The page includes information on the best practices to follow when backing up the recovery seed.

  5. You will then need to confirm the backup phrase:

  6. You have now successfully installed MetaMask. You will now need to change it from Ethereum to Ether-1:

Add a custom PRC network

Once the custom RPC value is put in above, you will see the ETHO balance of your imported account, however the MetaMask client will say it's your ETH balance. This is because MetaMask focuses on working with the Ethereum ETH coin name. Keep in mind you're connected to the Ether-1 network, so you're dealing with your ETHO balance.

Importing Existing Wallet to MetaMask

This optional section of the guide details how you can import an existing wallet into MetaMask. These steps are applicable to both stock MetaMask and the Ether-1 version.

  1. From the MetaMask application, select the purple circle in the upper right hand corner. Then select 'import wallet', as shown in the screenshot below:

  2. Now, depending on the format which your existing wallet is in, you have the choice to pick between a JSON file and a private key string:

  3. You can paste the private key into the field, or upload the JSON file using the file explorer.

Imported accounts will not be associated with your originally created MetaMask account seed-phrase. Learn more about imported accounts here.

Uploading Data to ethoFS

Only one version of MetaMask can be installed when using ethoFS, so be sure to disable / remove one version if you have both installed to avoid running into issues.

To upload data to ethoFS after having installed, and logged into, one of the versions of MetaMask (As described above) you can go to to get started.

  1. You will be prompted to make a username, this will register your MetaMask address with ethoFS.

  2. After inputting a username, you will be prompted to make a verification transaction through MetaMask.

  3. After approving the transaction, you will need to wait a short while for ethoFS to setup the user. After this, you will be able to press 'enter' to continue. You will then be logged into ethoFS!

Now you are able to upload data to ethoFS, please see the video tutorial below if you need assistance in using the ethoFS dashboard. Alternatively you can follow the steps in How to upload a website on ethoFS for a written guide of how the system works.

How to upload data to ethoFS Video Guide.