Mining Guide

Last updated 18 days ago

Want to start mining on Arweave? You've come to the right place! Get set up with this quick and easy guide, and join our awesome network of ever-growing miners.

For any questions and support queries regarding mining on Arweave, we strongly recommend that you join our Discord server as this is the hub of our mining and developer communities. Here you will find plenty of community members and Arweave team members available to help you out 🤖

Preparation: Linux

  1. Install an up-to-date version of Erlang (Erlang/OTP 20+), git and libssl-dev or equivalent

    (usually available from your Linux distribution’s package manager)

  2. Use git to clone the latest stable release using the following command:

git clone arweave && \
cd arweave && git -c advice.detachedHead=false checkout stable

Alternatively, you can simply run this script on a fresh Ubuntu installation. Because this script installs dependencies for you it will require your root password, so please make sure you are comfortable with the commands that it will run before execution. You can download and execute the script with this command:

curl | bash

Preparation: Other Operating Systems

In order to run the Arweave miner on Mac OS X please execute the following steps:

  1. Install Homebrew​

  2. Run ‘brew install erlang@20’

  3. Finally, run the following command:

git clone arweave && \
cd arweave && git -c advice.detachedHead=false checkout stable

It is also possible to set-up an Arweave mining environment on Windows using the ‘Windows Subsystem for Linux’ or a virtual machine environment

Running the Miner

Now you’re ready to start the mining process by using the following command from the Arweave directory:

./arweave-server mine mining_addr YOUR-MINING-ADDRESS peer peer peer peer peer peer peer peer

Please replace YOUR-MINING-ADDRESS with the address of the wallet you would like to credit when you find a block!

If you would like to see a log of your miner’s activity, you can run ‘make log’ in the Arweave directory in a different terminal. The miner terminal itself is left clear so that you can interact with the system using the console.

Staying up to Date

Once you are successfully mining on the Arweave, you will need to stay up to date with new releases. Join our mailing list to receive emails informing you that a new update has been released, along with the steps you need to take to stay up to speed. Updates that require you to perform an action within a certain time period in order to stay in sync with the network will be labeled ‘[ACTION REQUIRED]’. Keep an eye out for these messages, and if possible make sure that you add to your email provider’s trusted senders list!