Tutorial: Mining AE on Ubuntu 18.04


Hey everyone,

We are happy to share the step-by-step guide on how to start mining on the æternity Testnet.

It was created to help æternity users start mining on the Testnet and be ready to quickly switch to the Mainnet, once it launches.

We are grateful to our Chinese æmbassador @imae.one for preparing this :slight_smile:

Best regards,


chinese developers can see the video record here : https://v.qq.com/x/page/b0718t5ta5w.html


Thank you for preparing this guide @imae.one!


Thank you for the tutorial :+1: I will try to do this in the coming week but i have some questions .
Is this cpu mining?
No gpu mining? No ccminer or other software?It’s like solo mining… If multiple rigs is there way to let them join the rig on the solo pool?
Or you have to do this on each rig?


Hi @JeanD,

Indeed the tutorial covers CPU mining only. You can read more about GPU mining in the technical document.

In regards to mining pools, there is in-progress PT ticket to add API endpoints that would allow implementation of mining pools.


I just did the whole tutorial on both Arch and Ubuntu, but I have the same problems on both distros.

When I do step 6, curl I get the error `curl: (7) Failed to connect to port 3013: No route to host.

Also when I do curl http://localhost:3013/v2/accounts/<my address> I get the error: {"reason":"Account not found"} even though the node has been running all night and seems to have sucesfully mined blocks (according to epoch_mining.log).

What am I doing wrong?


You can switch to the following URLS

And ‘account not found’, i guess it’s not mined new block yet


This seed node has been shutdown. It will be announced in the next release notes. In the meantime you can get the up-to-date seed nodes list at https://github.com/aeternity/epoch/blob/master/docs/release-notes/RELEASE-NOTES-0.24.0.md#inspect-the-testnet


The tutorial has been updated to change the outdated seed address.


Thank you for the links. That solved that part indeed. However I do notice that my node is completely out of sync.

{"difficulty":1.0,"genesis_key_block_hash":"kh_2ngPedVNMHwLSVvbeqo1EYk9KzK6ajy3yLJ9eehKbF4hVYM7nR","listening":true,"node_revision":"0648df63218bffa8c2a9c79255c83fc7a5a45b1a","node_version":"0.22.0","peer_count":4,"pending_transactions_count":0,"protocols":[{"protocol":{"effective_at_height":0,"version":23}}],"solutions":0,"syncing":true}[[email protected] node]

contents of epoch.yaml:

  port: 3115
  external_port: 3015

  dir: keys
  password: "password"

    port: 3013
    port: 3113

    port: 3114
    port: 3014

  beneficiary: "ak_2mgfokMgpxQCCdf1r8c7c5GVWmh7rf8cEJvUemqpVF3HMdEYvY"
  autostart: true

  persist: true
  db_path: ./my_db


yean, make sure the hash is sync to the testnet.


Somehow the node doesn’t want to sync. My node keeps being stuck on the above mentioned block 117.

When I check log/epoch_sync.log I see quite a lot of this kind of errors:

2018-10-10 14:21:56.860 [info] <0.4538.0>@aec_peer_connection:handle_info:322 Connection handshake failed - timeout was from <<"">>
2018-10-10 14:21:56.860 [debug] <0.3358.0>@aec_peers:on_connection_failed:805 Peer "pp_QU9CvhA...G4o16Bf" - connection to failed by process <0.4538.0>
2018-10-10 14:21:56.860 [debug] <0.3358.0>@aec_peers:schedule_connect:715 Waiting 100 ms for the next connection
2018-10-10 14:21:56.961 [debug] <0.3358.0>@aec_peers:connect:677 No peers available befor 566180 ms
2018-10-10 14:21:56.961 [debug] <0.3358.0>@aec_peers:schedule_connect:715 Waiting 566180 ms for the next connection
2018-10-10 14:21:59.032 [info] <0.4540.0>@aec_peer_connection:handle_info:322 Connection handshake failed - timeout was from <<"">>
2018-10-10 14:21:59.032 [debug] <0.3358.0>@aec_peers:on_connection_failed:805 Peer "pp_27xmgQ4...jxtFuAu" - connection to failed by process <0.4540.0>
2018-10-10 14:21:59.032 [debug] <0.3358.0>@aec_peers:schedule_connect:715 Waiting 100 ms for the next connection
2018-10-10 14:21:59.133 [debug] <0.3358.0>@aec_peers:connect:677 No peers available befor 564008 ms
2018-10-10 14:21:59.133 [debug] <0.3358.0>@aec_peers:schedule_connect:715 Waiting 564008 ms for the next connection


@imae.one @arjanvaneersel, I have the same issue. Any news/solution on this?



i thought it might be problem of version.

you should check the version , run ‘’‘’
and ‘’‘’,

Compare the local version with the testnet.

If the version dont match, then download and use the latest version epoch.


Indeed, it does not match the version. I seem to have version 23 instead of 25 as I can see at: ’

I’m going to try and update epoch. Can I reuse the already generated pub key?

Thanks @imae.one!


It depends on the version you had, but I would try. It should work in recent few releases.


@rrotteveel @arjanvaneersel Indeed it looks like version mismatch to me as well.


My Epoch version is 0.22: epoch-0.22.0-ubuntu-x86_64.tar.gz

Do I need to compile the latest?


You would need the latest release to join the testnet for sure. My comment was about the keypairs, sorry for not being explicit enough.


I compiled the latest Maintenance release and it’s working like a charm! Thanks @dincho! Kudos to you!