Arweave Entrypoint

How to use the Arweave entrypoint script

0. ./bin/start vs. ./bin/arweave

This guide covers the core Arweave entrypoint: ./bin/arweave. That entrypoint provides a lot of useful functionality. However when launching your node it is recommended that you use ./bin/start.

./bin/start wraps ./bin/arweave foreground and includes a naive auto-restart functionality. If your node crashes, ./bin/start will wait 15 seconds and then start it again.

1. Arweave Entrypoint

The Arweave entry-point located in bin/arweave integrates all required subcommands in one place. To print the help page, execute the script:

./bin/arweave

It is also possible to have a more detailed help of one particular subcommand by passing it after the help one.

./bin/arweave help ${subcommand}

2. Start Arweave

Arweave can be started in many different ways depending of the needs and all these methods can be used with ./bin/arweave entry-point. Most of the users are using ./bin/start to start an arweave node, this script is equivalent to:

./bin/arweave foreground ${parameters}

To have access to Arweave output directly from the terminal (without the Erlang console) the following command can be used. It could be used with any process manager like systemd, because the VM will not fork.

./bin/arweave foreground ${parameters}

To have access to Arweave output directly from the terminal with an Erlang console:

./bin/arweave console ${parameters}

Arweave can also be started as an Unix daemon (in background) by executing the following command:

./bin/arweave daemon ${parameters}

To reattach a daemon (and having access to the Erlang console), one can execute the subcommand daemon_attach.

./bin/arweave daemon_attach

3. Arweave Status

To ensure a node is correctly running, one can ping it using ./bin/arweave entry-point. The script will return the string pong if the node is up.

./bin/arweave ping

The same information can be available by using the subcommand status, except nothing will be printed. The command will return 0 if the node is up and 1 if the node is down. Useful for monitoring scripts.

./bin/arweave status

Finally, to see if the node is reachable, it is also possible to use external software like curl:

curl http://localhost:1984/

4. Remote Console

An Erlang shell can be invoked to control the Erlang VM where Arweave is running. The ./bin/console script can be used and it is equivalent to execute this command:

./bin/arweave remote_console

The shell can be ended by pressing Ctrl + C.

5. Stop Arweave

An Arweave node can be stopped by using the script ./bin/stop or by executing the following command:

./bin/arweave stop

It can take some time for the node to shutdown. If you can, it is best to wait for the node to complete its shutdown process. However if you can't wait, you can kill the arweave and beam.smp processes using kill -1.

Sending a SIGKILL (kill -9) is not recommended as it can cause data corruption.

6. Custom Erlang VM Arguments

The first - and easiest - method is to pass the new argument directly from the command line, all arguments before -- will be used to overwrite the default VM parameters of the Erlang VM. All arguments after -- will be used for Arweave.

Example:

./bin/start +MMscs 131072 +S 16:16 -- config_file config.json

The second method is to modify the rel/arweave/releases/${arweave_release}/vm.args.src file. This file contains all default parameters used by Arweave with some links to the official documentation to help anyone wanting to optimize the Erlang VM.