Skip to main content

Command-line options

This section lists the various flags used to customise the startup process of Prysm.

Beacon Node Configuration#

Below are all the available configuration parameters for the Prysm beacon node grouped by functionality. All information is retrieved from the latest Prysm release.

Loading parameter list...

Validator Configuration#

Below are all the available configuration parameters for Prysm validator client grouped by functionality. All information is retrieved from the latest Prysm release.

Graffiti

You can use the --graffiti validator flag to add a string to your proposed blocks, which will be seen on the block explorer. I.e; <startup command> --graffiti "Prysm is awesome!"

Loading parameter list...

Client Stats Configuration#

Below are all the available configuration parameters for Prysm client stats software: an optional service that can report process metrics to third-parties such as block explorers. You can read more about this here.

Loading parameter list...

Loading Parameters via a .YAML File#

info

Loading parameters via .YAML file is optional.

Prysm now supports loading flag values from a specified .yaml file. Defining parameters in this way cuts back on terminal clutter and allows unique startup profiles to be saved independently.

The below steps show how place a common Prysm flag into a YAML file and how to specify it at start up.

GNU\Linux, Mac, ARM64#

  1. In your Prysm working directory, create a .yaml file and open it in a text editor.

  2. Add the following lines to the file before closing and saving:

datadir: '/data'
  1. Start the Prysm beacon chain as normal, while specifying the location of the .yaml like so:
./prysm.sh beacon-chain --config-file=/path/to/file.yaml

or for a validator like so:

./prysm.sh validator --config-file=/path/to/file.yaml

Windows#

  1. In your Prysm working directory, create a .yaml file and open it in a text editor.

  2. Add the following lines to the file before closing and saving:

datadir: 'c:\prysm'
  1. Start the Prysm beacon chain as normal, while specifying the location of the .yaml like so:
.\prysm.bat beacon-chain --config-file=c:\path\to\file.yaml

or for a validator like so:

.\prysm.bat validator --config-file=c:\path\to\file.yaml

It is possible to provide additional flags alongside the .yaml file, though if conflicting flags are provided, the flag defined in the.yaml file will take priority. For example, if the flag --datadir=/data2 is specified and datadir: "/data1" is in the .yaml file, Prysm would prioritise writing to /data1.