Join GitHub today
GitHub is home to over 31 million developers working together to host and review code, manage projects, and build software together.Sign up
Install RskJ Using Aws
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:
On the Launch with EC2 page, choose the RSK Node Orchid MainNet.
Select the Region from the drop-down list. The hourly usage charges for your region are shown under Pricing Details.
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.
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.
Click the Next: Add Storage button.
Keep the default hard drive settings. (Optional) Add another EBS for additional storage.
(Optional) Enter the tag information as needed. Click the Next: Configure Security Groups button.
(Optional) Choose one of the following:
- Create a new Security Group.
- Select an existing Security Group.
- Click the Review and Launch button.
Review the RSK Orchid MainNet Node configuration. Don't forget our recommended minimum requirements.
- Click Launch.
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
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
We hope our Troubleshooting section can help you!