Setup a Cloud Server

Using Hummingbot as a long running service can be achieved with the help of cloud platforms such as Google Cloud Platform, Amazon Web Services, and Microsoft Azure. You may read our blog about running Hummingbot on different cloud providers.

Below, we show you how to set up a new Virtual Machine Instance on each major cloud platform.

Tip: Access Cloud Instances on your Phone

Use Hummingbot's Telegram Integration to connect to your cloud instance without a computer. Note that this has limited functionality and remains a work in progress.

Google Cloud Platform

  • Navigate to the Google Cloud Platform console
  • Create an instance of Compute Instance
  • Select “New VM Instance”, then pick Ubuntu 18.04 LTS

Create New Instance

  • Click on "SSH" to SSH into the newly created VM instance

Connect SSH

Amazon Web Services

  • Navigate to the AWS Management Console
  • Click on "Launch a Virtual Machine"

Create New Instance

  • Select Ubuntu Server 18.04 LTS (HVM)

Select Server Type

  • Choose an Instance Type:

    The Free tier t2.micro option should be enough for beginner user running a single bot.

    Select Instance Type AWS's t2.micro instance allocates 7.7 GB of storage by default. After docker and hummingbot installation, 3.5 GB remains for logs and data files generated by the client.

    If you are running multiple bots in the same instance, you may want to consider choose an Instance Type that offers more storage.

    After you have chosen an Instance Type, click on "Review and Launch", and then "Launch"

  • Select “create a new key pair”, name the key pair (e.g. hummingbot), download key pair, and then click on “Launch Instances”.

Create a New Key Pair

  • Click on “View Instances”

  • To connect to the instance from the terminal, click on “Connect” and then follow the instructions on the resulting page.

Connect to AWS Instance

Microsoft Azure

  • Navigate to the Virtual Machines console.
  • Click on the "Add" button in the top-left corner.

Create New Instance

  • Choose a name for the resource group and for the VM itself.
  • Select Ubuntu 18.04 LTS for the image type and Standard D2s v3 for the size.

Select Server Type

  • Under "Administrator Account", choose password and select a username and password.
  • Under "Inbound Port Rules", select SSH and HTTP.

Configure Server Protocols

  • Scroll up to the top and click on "Management" tab.
  • Choose a valid name for your diagnostics storage account.

Set Up Diagnostics

  • Go to the "Review and Create" tab, click on "Create".

Create the Virtual Machine

  • While your VM is being created, download and install PuTTY for your OS.

Download and Install PuTTY

  • After your VM has been initialized, copy the public IP address.
  • Open the PuTTY app and paste the IP address into the host name, then open.

Connect to Azure Instance

Next: Install Hummingbot for Linux