Updated on 12-12-2018


This is step-by-step guide that will show you how to install and start using Sonm to rent computing resources and execute tasks. The installation will not affect your operating system or files.

You’ll need to consider the following before starting the installation:

  • Connect your laptop/PC to a power source. The PC may have MacOS, Windows, or Linux.
  • Ensure you have an internet connection and browser.

Follow the next steps to start installation.


It’s easy to install the Sonm components for Customers (CLI, Node). Here’s what you need to do:

  1. Open cmd.
  2. Use the auto-installation script: sudo bash -c "$(curl -s https://raw.githubusercontent.com/sonm-io/autodeploy/master/sonm-auto-deploy-consumer.sh)".
  3. After installation, the components for Customers (CLI, Node) will launch automatically.

We recommend the auto-installation, but you may also install the Sonm components manually:

Account settings: Keystore file

You must have your own Ethereum account to pay for resources in Sonm.
Your account is your unique identifier for…

  • deals on the Sonm blockchain
  • profile certificates, deal statistics, contact information, etc.
  • personal blacklists (common for all supplier workers to not enter into deals with the specified addresses)

We generate your personal account (UTC/JSON keystore file) during the installation. You can find the keystore path and passphrase with cat ~/.sonm/cli.yaml. Keystore file default location: /etc/sonm/sonm-keystore.

If you want to use your existing account, replace the file in the appropriate folder with yours.

Account settings: Create new wallet

To start working with your account:

  1. Get your keystore file. The default keystore file location is /etc/sonm/sonm-keystore.
  2. Open the Sonm Market.
  3. Create a new wallet by clicking the “Create wallet” button. Input a name, password, and password confirmation and choose “livenet” as the Ethereum network (“rinkeby” is a testnet).
  4. Then, click “Create wallet”. You will see your wallet in Sonm Market without any accounts.

Next, you need to add your account to your wallet.

Account settings: Add account

  1. Select “Wallet” -> “Accounts” in the main menu. This will take you to the account list.
  2. Click the “Import Account” button to add your UTC/JSON keystore file. Select the file and enter the account name and passphrase. Click “Add” to finish.
  3. Now you will see your account in the list and your funds in Ethereum and Sonm tokens. Your account is now set up.
  4. To verify the installation of the Sonm CLI component and to check your account, start the Sonm CLI and use the ‘sonmcli login’ command. There should be no “Enter password” request.

Payments: Buy SNM

Payment for resources on Sonm is performed in Sonm tokens (SNM) only.

You can buy tokens on the cryptocurrency exchanges mentioned on our site.

You must have on your account enough SNM to pay for the deal and some Ethereum to pay for the deposit operation (Ethereum transaction fee).

Payments: Deposit tokens

Deposit tokens are required for replenishing your balance on the Sonm blockchain, where you rent and pay for resources. You may use the Sonm Market or Sonm CLI.

To deposit tokens in the Sonm Market:

  1. Go to “Market” -> “Deposit.”
  2. Set the value of the deposit in SONM tokens and the fee parameters (gas limit, gas price). You must have enough Ether and tokens on your main balance. Click “Next.”
  3. Check the values and input your account password. Click “Deposit.”
  4. Wait for the transaction to complete. View your changed balance!

To deposit tokens in the Sonm CLI:

  1. Open cmd (once the Sonm components have been started).
  2. Use the ‘sonmcli token deposit’ command.
    Please NOTE

    We use special Gate smart contracts and Gatekeeper masternodes to validate transactions for depositing SNM tokens to the Sonm blockchain and withdrawing them to the main Ethereum network. The transactions are not instantaneous – there are delays:

    • validation of transactions (including transactions to the blockchain) – this depends on the current workload of the main Ethereum network and your transaction settings (“gas limit” and “gas price”)
    • quarantine period for the gate – 15 minutes

    Taking this into account, the average time it takes to deposit funds in the respective other blockchain is the time it takes to mine your transaction + 15 minutes

Pass KYC

KYC (know your customer) is a procedure that allows the supplier to confirm the identity of the counterparty (customer) participating in a deal before it is conducted. After undergoing KYC verification, customers can use the resources they have rented on the Sonm platform to run individually created tasks: machine learning, rendering, etc. Users who have not yet passed the KYC procedure can run only the computational tasks included in the Sonm Whitelist.

To complete the KYC procedure and receive “Identified” status, you need to:

  1. Go into your profile in the Sonm Market and click your profile icon at the top.
  2. Click the “Get Certification” button.
  3. Select “Cryptonomica” from the list and follow the steps.
  4. After the KYC is completed, your status will be changed to “Identified.”

Rent resources: Quick rent

To quick rent resources use the Sonm Market:

  1. Go to “Market” -> “Orders”.
  2. Choose an appropriate sell order. Click on the order to see all parameters.
  3. If you want to buy it, click the “Buy” button.
  4. After that, if the order has a limited duration, you may set your duration value, which must be equal to or less than that of the supplier. For non-limited orders, you do not need to complete this step.
  5. Check all the parameters and confirm the deal: enter your account password and click “Buy.”
  6. Wait a little, and after your deal is created, you will receive a notification.
  7. You may see your deals on the “Market” -> “Deals” page. You may view the deal details by clicking on the deal.

Order and deal prices on the Sonm marketplace are in USD. Payments are executed in SNM tokens in accordance with the current SNM/USD exchange price. When you open a deal, SNM tokens are transferred from your address to the marketplace smart contract.

Rent resources: Manual configuration

If the configuration you need is not available for rent on the Sonm Market at the moment, you can set up manual configuration using Sonm CLI:

  1. Configure the buy-order parameters necessary for your task: create or edit the bid.yaml file
    1. Configure the values ​​of RAM, CPU, network, and GPU hashrate. Set the price you’re offering.
    2. Set the duration of the deal. Zero means that the deal is spot and can be interrupted by the supplier at any time. To perform a machine-learning task, set the time of the deal as the minimum time required to complete your task.
  2. Create an order on the Marketplace to buy resources: sonmcli order create bid.yaml.
  3. Wait a few minutes and check whether the deal has been settled: sonmcli deal list. The deal is automatically created as soon as a suitable sell order is found on the Sonm marketplace.

Execute the task: Make your Docker image

To execute your task, you should prepare a docker container with it and upload the container to the Docker storage. To make your custom Docker image use our guide.

Execute the task: Run

For now, task execution is possible only through the Sonm CLI. Follow the steps below:

  1. Prepare a file with a description of the task: edit the task.yaml file. You can find task specification examples on our GitHub page.
  2. Start the task using the command sonmcli task start <deal_id> task.yaml –timeout=100m.
  3. Wait until the task has started. This process can take a long time because the worker needs to pull up the docker image.
  4. See the task logs using the command sonmcli task logs <deal_id> <task_id>.

Finish the deal

  1. After the task execution has ended, stop the task: sonmcli task stop <deal_id> <task_id>.
  2. If you don’t have any other tasks planned, don’t forget to finish the deal to stop spending Sonm tokens: sonmcli deal close <deal_id>.

The supplier will receive payment for the deal duration. The rest of the frozen SNM tokens are returned to your account!

See the Sonm CLI Guide for additional information about task management.

Finding help

If you get stuck, help is always available. We provide you with 24/7 technical support.

If you experience any errors or difficulties with our product, you can get support via…

Please be ready to provide all the required information to help us solve your issue.

Check if your Sonm platform components are working correctly using our self-check guide.

Also, please write up a step-by-step description of the actions that led to the error and provide us with the command outputs.

Next step