/aws-ethereum-miner

CloudFormation template for mining Ethereum crypto currency on AWS

Primary LanguagePython

AWS Ethereum miner

CloudFormation template for mining Ethereum (ETH) crypto currency on AWS GPU-enabled EC2 instances

Important!

Quick start

  1. Login to your AWS account and have your Ethereum wallet address ready

  2. Launch the stack in one or more of the cheapest regions. Sometimes spot capacity is not available in a particular region, in that case try a different one.

  3. Most users should use the Default VPC template. However if your AWS account is very old and still supports EC2-Classic instances you will have to use the Custom VPC template instead and select the VPC and Subnets manually (and yes you can select the default VPC and default subnets). Do not worry - you will be prompted by the Default VPC template if this is the case.

    TL;DR Start with the Default VPC template and see if it works.

You will have an opportunity to check the stack details, enter the wallet address, etc, before the stack is launched.

Region Default VPC Custom VPC
ap-northeast-1 Tokyo Launch to Default VPC Launch to Custom VPC
ap-northeast-2 Seoul Launch to Default VPC Launch to Custom VPC
ap-northeast-3 Osaka Launch to Default VPC Launch to Custom VPC
ap-south-1 Mumbai Launch to Default VPC Launch to Custom VPC
ap-southeast-1 Singapore Launch to Default VPC Launch to Custom VPC
ap-southeast-2 Sydney Launch to Default VPC Launch to Custom VPC
ca-central-1 Central Launch to Default VPC Launch to Custom VPC
eu-central-1 Frankfurt Launch to Default VPC Launch to Custom VPC
eu-north-1 Stockholm Launch to Default VPC Launch to Custom VPC
eu-west-1 Ireland Launch to Default VPC Launch to Custom VPC
eu-west-2 London Launch to Default VPC Launch to Custom VPC
eu-west-3 Paris Launch to Default VPC Launch to Custom VPC
sa-east-1 São Paulo Launch to Default VPC Launch to Custom VPC
us-east-1 N. Virginia Launch to Default VPC Launch to Custom VPC
us-east-2 Ohio Launch to Default VPC Launch to Custom VPC
us-west-1 N. California Launch to Default VPC Launch to Custom VPC
us-west-2 Oregon Launch to Default VPC Launch to Custom VPC

Which region should I use?

Not all instance types are available in all regions. Use the table below to choose the region which supports your desired instance type.

Also note that the Spot and On-Demand prices differ between the regions. The US regions are typically slightly cheaper but often have availability issues, especially on Spot. The non-US regions are a little more expensive but may have the desired instance types available more readily.

Instance regions

What does the template do?

  • Spins up an AutoScaling Group with Spot Instances of the specified instance types, with the most efficient attempted first (usually g5.xlarge, g4dn.xlarge, etc ...)
    • Use template-eth-default-vpc.yml if you want to spin up the instances in the Default VPC (most users).
    • Use template-eth-custom-vpc.yml if you have your own VPC that you want to use (advanced users). The Subnets must have direct or NAT access to the internet! Make sure that the VPC matches the Subnets selected!!
  • Runs ethminer with the right options for mining with the ethermine.org pool upon the instance start

Increase resource quotas

All right you have created the stack but no instances seem to be running. If you navigate to EC2 -> Autoscaling groups -> ethminer -> Events tab you may see this error:

Failed: Launching a new EC2 instance.

Status Reason: Max spot instance count exceeded. Launching EC2 instance failed.

AWS accounts have default limits (quotas) on some resources. You may find, for example, that your quota for All G and VT Spot Instance Requests in a particular region is 0 and you therefore can't start any g4dn.xlarge instances. It pays to request the quotas increase which can be done with this simple command (you can do this from the CloudShell):

export AWS_REGION=us-west-2 # Oregon
export CODE=L-3819A6DF      # All G and VT Spot Instance Requests (for g5.xlarge, g4dn.xlarge, etc)
# export CODE=L-7212CCBC    # All P Spot Instance Requests (for p3.2xlarge, p3dn.24xlarge or p4d.24xlarge)
export VCPUS=96             # 96 vCPUs - can accommodate e.g. 24x g4dn.xlarge or 1x p4d.24xlarge

aws --region ${AWS_REGION} service-quotas request-service-quota-increase --service-code ec2 --quota-code ${CODE} --desired-value ${VCPUS}

Choose the number of vCPU and the Quota code according to your needs.

Expand to Los Angeles (us-west-2-lax-1)

Spot instance capacity for g4dn.xlarge instances is in short supply in the cheapest regions, even though the spot prices are still very very low. You may have to wait for a long time to get an instance.

Interestingly the Los Angeles local zone seems to have plenty of g4dn spot capacity at the same price as Oregon, however you have to opt-in to be able to use it. Here is how (you can do this from the CloudShell):

  1. Opt-in to the LAX zone with:
    aws --region us-west-2 ec2 modify-availability-zone-group --group-name us-west-2-lax-1 --opt-in-status opted-in
    
  2. Create new default subnets in the 2 LAX AZs in the default Oregon VPC:
    aws --region us-west-2 ec2 create-default-subnet --availability-zone us-west-2-lax-1a
    aws --region us-west-2 ec2 create-default-subnet --availability-zone us-west-2-lax-1b
    
  3. Delete and re-deploy the CFN stack in us-west-2 (Oregon) - it will pick up the 2 new AZs and launch the instances.

Tell me more ...

Check out the instructions in my Medium article, it contains some important considerations. Alternatively, if you think you know what you are doing follow these instructions:

  • Have your Ethereum wallet address ready. Best to use MetaMask as it will let you manage the Ethermine pool payouts.
  • Login to your AWS account.
  • Click the Launch link or create the stack manually:
  • Check your mining progress on Ethermine dashboard.
    • Note that it takes some time (15 ~ 30 mins) before your stats start to appear, and
    • The reported hashrate speed ramps up slowly to the sustained rate over the first hour or so, I believe due to delays in reporting and some averaging.
    • From my tests the hashrate reported by the ethminer process is correct and that's what you get paid out. Even if the dashboard speed is lower.
  • When done delete the stack.

Author

Michael Ludvig, you're welcome :)

Did you make some profit using this template and wish to say thanks? Any ETH amount sent to my address will be much appreciated: 0x99b36B44cf319c9E0ed4619ee2050B21ECac2c15

0x99b36B44cf319c9E0ed4619ee2050B21ECac2c15

Thanks! :)