Skip to content

Install RskJ Using Aws

jonathansmirnoff edited this page Jul 19, 2019 · 7 revisions

Following the instructions below you will install and run the RSK node in AWS Marketplace AMI. By default, the node connects to MainNet. If you want to change the network read this section. If you want to change some configuration, please refer to our RSK node configuration section.

Install the node using AWS

These are the steps to run the node:

  1. On the Launch with EC2 page, choose the RSK Node Wasabi MainNet.

  2. Select the Region from the drop-down list. The hourly usage charges for your region are shown under Pricing Details.

  3. Click the Launch with EC2 Console button for your region. The window to select the instance type displays. Select the General purpose tab for the supported instance types. Select the instance type. Click the Next: Configure Instance Details button.

  4. Configure the instance details. Using the Network drop-down list, select the network option.

    • Select a VPC subnet from the drop-down menu. Keep in mind that this determines the availability zone of your instance.
    • Select the availability zone from the drop-down menu.
    • Select additional options available from AWS.
  5. Click the Next: Add Storage button.

  6. Keep the default hard drive settings. (Optional) Add another EBS for additional storage.

  7. (Optional) Enter the tag information as needed. Click the Next: Configure Security Groups button.

  8. (Optional) Choose one of the following:

    • Create a new Security Group.
    • Select an existing Security Group.
    • Click the Review and Launch button.
  9. Review the RSK Wasabi MainNet Node configuration. Don't forget our recommended minimum requirements.

    • Click Launch.
  10. When prompted, enter the key pair information. The key pair consists of a public key stored in AWS and your private key used to authenticate access to the instance. Choose one of the following:

    • Choose an existing key pair
    • Create a new key
  11. Click Launch Instance. It takes approximately 10 minutes to deploy the AMI instance. You can view the status by clicking on the Instances link on the menu. Wait for the State to show Running and the Status Checks to show passed.

Switch from MainNet to TestNet or RegTest Mode

If you want to switch your node from MainNet to TestNet/RegTest mode, you should connect a bash to the node and run:

  • For TestNet:
sudo service rsk stop
cd /etc/rsk
sudo rm -f node.conf
sudo ln -s testnet.conf node.conf
sudo service rsk start
  • For RegTest:
sudo service rsk stop
cd /etc/rsk
sudo rm -f node.conf
sudo ln -s regtest.conf node.conf
sudo service rsk start

Also, if you want to return to MainNet mode:

  • For MainNet
sudo service rsk stop
cd /etc/rsk
sudo rm -f node.conf
sudo ln -s mainnet.conf node.conf
sudo service rsk start

Any problems?

We hope our Troubleshooting section can help you!

Clone this wiki locally