Linux One-liners to download and run Ergo node

Now it is possible to download and run Ergo with one command in Linux.

Basic command for non-mining full-node is:

curl -s | sh -s -- --mode=full --app-dir=~/ergo --api-key=MY_API_KEY

just change folder where the node is to be installed (–app-dir, --app-dir=~/ergo in our example), and set your API key instead of MY_API_KEY in the example

The command above is downloading and running UTXO-storing and non-mining full node. To have a mining full node, run the script with --mode=mining flag:

curl -s | sh -s -- --mode=mining --app-dir=~/ergo --api-key=MY_API_KEY

and then simply go to for initializing the wallet and then running miners with the mnemonic provided!


sudo apt install daemon default-jre-headless
on ubuntu 19 for dependecies

2 Likes possibly could add the address http://localhost:9053/panel

seems to me that till one of the 2 options (restore or initialize wallet) github .com/ergoplatform/ergo/wiki/Set-up-a-full-node#initialize-wallet everything should be managed from a script, also if that secret stuff is only for local encryption why isnt automatically generated and installed in the config? I dont see where is the interest of the user in setting that up.

also why is created an “Ergo” folder in the home path instead of “.ergo”? this isnt very nice.

PS seems i cant use more than 2 links, pls change this discourse setting XD

I do a little script to speed things up

random=$(< /dev/urandom tr -dc _A-Z-a-z-0-9 | head -c${1:-32})
blake_random=$(curl -sX POST "" -H "accept: application/json" -H "Content-Type: application/json" -d "\"$random\""); 

echo "
ergo {
  directory = \${}"/.ergo"
  node {
    mining = false
  wallet.secretStorage.secretDir = \${}"/wallet/keystore"
scorex {
 restApi {
apiKeyHash = $blake_random
" > ~/.ergo/ergo.conf

echo "restart ergo.jar and put "$random" in 'Set API key' in http://localhost:9053/panel" 

(im using the ~/.ergo folder so all you can do is change that if you use ~/Ergo one)


Hi @sogekingu ! Welcome to the community!

  1. The script is installing the node into the ~/Ergo by default, which is indeed pretty strange name for *nix systems. Thus before script update it is better to run it with --app-dir setting.

  2. It seems that the script is installing default-jre-headless and curl automatically? this

  3. on API secret key, the script is getting API key via parameters and setting its hash into config automatically. API key is needed in order to prevent access to certain parts of the API (such as /wallet methods) in case of e.g. unintended API exposure or against malware etc.


1 - uh, well I don’t notice that :confused:

2 - strange on ubuntu 16 didn’t work, (on 19 does) anyway also daemon is needed right?

3 - yes, I see, the thing is that I don’t understand why the user have to set that up, I guess trying to automate it that is quite tricky, but I’m not sure about that being the real reason.


It didn’t work for me on 16.04 as well.

EDIT: The following had to be done on 16.04 (fresh install)

sudo apt install curl
sudo apt install daemon
sudo apt install openjdk-9-jre-headless 

Script ran but got an error and empty application.conf created.

sed: -e expression #1, char 18: unknown option to `s'

See transcript below

zbox@vb:~$ curl -s | sh -s -- --mode=full --app-dir=~/ergo --api-key=MY_API_KEY
Ergo node with config file will be installed into '/home/zbox/Ergo' directory and will be named as '~/ergo' and has API key 'MY_API_KEY'.
Ergo directory '/home/zbox/Ergo' already exists.
Latest known Ergo release: v3.1.5, downloading it to /home/zbox/Ergo/ergo.jar with overwrite...
Ergo was downloaded to /home/zbox/Ergo/ergo.jar
Executing ergo node to obtain API key hash..................
API key hash obtained: 0e5751c026e543b2e8ab2eb06099daa1d1e5df47778f7787faab45cdf12fe3a8
Stopping Ergo node with PID=3784....
sed: -e expression #1, char 18: unknown option to `s'
Config file was written to /home/zbox/Ergo/application.conf
Starting node......................
Node started.
To stop the node later, use: kill 3926
zbox@vb:~$ cat Ergo/application.conf 
zbox@vb:~$ cd Ergo/
zbox@vb:~/Ergo$ ls -l
total 79936
-rw-rw-r-- 1 zbox zbox        0 Dec 24 21:06 application.conf
-rw-rw-r-- 1 zbox zbox 80026495 Dec 24 21:06 ergo.jar
-rw-r--r-- 1 zbox zbox  1820326 Dec 24 21:08 ergo.log

Same with 19.10 (blank application.conf)


yes, I see, the thing is that I don’t understand why the user have to set that up, I guess trying to automate it that is quite tricky, but I’m not sure about that being the real reason.

You mean why user needs to put API key into script parameters? What are simpler options then?

yes application.conf is blank

I mean that the thing could be setup in the script like the rest, generate a random secret, put the blake(secret) in the conf file and the secret in the interface, isnt that quite better? (I only see technical issue in this, at least using the API). Also atm you have to input the key every time on the interface, couldt this be handled by cookies or something (or better having an option to disable this if im on my local net)? I mean this is not the end of the planet but not really comfortable.

1 Like

oh it seems script had some problems with non-default folder, a developer released a fix it seems:

Please try (from develop branch):

curl -s | sh -s -- --mode=full --app-dir=/tmp/ergo --api-key=MY_API_KEY

it creates (in /tmp/ergo) the following application.conf file:

ergo.node.mining = false = “kushti-laptop”
scorex.restApi.apiKeyHash = “0e5751c026e543b2e8ab2eb06099daa1d1e5df47778f7787faab45cdf12fe3a8”

On API , its web representation is auto-generated by Swagger, we need to take a look whether its possible to do relaxed authentication there.

/panel is built by us, is its rules okay for you?


should be something like this:

echo "\nAPI key used: ${APP_KEY}"
echo "\nAPI key hash obtained: ${API_KEY_HASH}"

so user can actually use the API key to log in, but yes relaxation would be the best, honestly users shouldnt even care about the api key hash, that’s only to be set in the conf, he only cares about the api key to connect via interface, /panel is ok, i dont really care, the important is adding also a line at the end with something like: “connect to http://localhost:9053/panel to interact with node”

1 Like

I have tested the fixed code and seems to work on 19.10. I’ll check and revert for 16.04 later.
The directory used is /tmp. Perhaps it will be better to put it in home or let user specify.

But I don’t have any strong opinion on this.

1 Like

Good day! I use the line from the theme header to install ergo on linux, enter the api-key which I made on windows OS and get an endless download of the api-key in node. Please, help! I tried to enter both Api-key itself and Api-key hash.