Hop
Search…
Hop
Welcome
JS SDK
Hop Node
Getting started
Requirements
Configuration
Keystore
Staking
Installing Docker
Docker image
Running Docker container
EC2 Setup
Monitoring
Docker CloudWatch Logs
Prometheus Monitoring
AWS Parameter Store Setup
Running in Production
Securing Cloud Instance
Securing Server
SSH 2FA
Additional Security & Node Best Practices
CLI Commands
Contract State
Additional questions
TheGraph Subgraphs
Contract Addresses
Smart Contracts
RPC Endpoints
Fee Calculation
On the web
FAQ
Assets
Powered By GitBook
EC2 Setup
Set up a Hop Node on EC2. ⚠️ Hope Node is in beta. Use at your own risk!

Node Creation

Create an EC2 instance to run your Hop Node

On the AWS website

  1. 1.
    Go to https://console.aws.amazon.com/​
  2. 2.
    Sign into your AWS account
  3. 3.
    In the "services" search bar, type "EC2" and click on the first result
  4. 4.
    Click "Launch Instance"
  5. 5.
    Select "Ubuntu Server 20.04 LTS (HVM), SSD Volume Type"
  6. 6.
    Search for the instance type "m5.large" and select this instance
  7. 7.
    Click "Next: Configure Instance Details"
  8. 8.
    Click "Next: Add Storage"
  9. 9.
    In the "Size (GiB)" column, use "100" instead of the default "8"
  10. 10.
    Click "Review and Launch"
  11. 11.
    Click "Launch"
  12. 12.
    Select "Create a new key pair" and name it "hop-node"
  13. 13.
    Click "Download Key Pair" and save the .pem file on your machine
  14. 14.
    Click "Launch Instances"

In the Terminal on your local machine

  1. 1.
    Navigate to the directory where you downloaded your .pem file (for example, try cd ~/Downloads)
  2. 2.
    Run the following commands to set up your Hop Node directory and server access.
i. Create .ssh directory if not existing already:
1
mkdir ~/.ssh
Copied!
ii. Move .pem file to the ssh directory:
1
mv ~/Downloads/hop-node.pem ~/.ssh
Copied!
iii: Change the permission of the .pem file for SSH:
1
chmod 400 ~/.ssh/hop-node.pem
Copied!

On the AWS website

  1. 1.
    Navigate to your EC2 instances (this should be the page you were on last)
  2. 2.
    Select your instance and click the "Connect" button
  3. 3.
    Choose "SSH client"
  4. 4.
    Copy the last line labeled "Example"
In the Terminal on your local machine
  1. 1.
    Paste the command you copied and run it
  2. 2.
    When prompted, type "yes" and click enter

Docker Installation and Node Set up

On your new EC2 Ubuntu instance, install Docker and pull the latest Hop Node:
1
sudo apt-get update
Copied!
1
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
Copied!
1
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"
Copied!
1
sudo apt-get install docker-ce -y
Copied!
1
sudo usermod -aG docker $USER
Copied!
1
newgrp docker
Copied!
1
docker pull hopprotocol/hop-node
Copied!
Set up the Hop Node configuration:
1
mkdir ~/.hop-node
Copied!
1
vim ~/.hop-node/config.json
Copied!
In this file, paste the default configuration example:

Keystore Generation and Funding

Generate the Keystore that will be the Hop Bonder.
1
docker run -v ~/.hop-node:/root -it hopprotocol/hop-node keystore generate --path /root/keystore.json
Copied!
Follow the instructions in your terminal and return to this page upon completion.
The command ends by printing the public key associated with your Hop Bonder. You may now send funds to that address.

Running the Bonder

Run the following command to run the Hop Bonder
1
docker run -d hop-bonder -v ~/.hop-node:/root -it hopprotocol/hop-node --config /root/config.json
Copied!
Previous
Running Docker container
Next
Monitoring
Last modified 5mo ago
Copy link
Contents
Node Creation
Docker Installation and Node Set up
Keystore Generation and Funding
Running the Bonder