consensys.lighthouse

Ansible Role: Lighthouse

Description

This Ansible role installs, configures, and runs Lighthouse.

Table of Contents

Supported Platforms

* MacOS
* Debian
* Ubuntu
* Redhat (CentOS/Fedora)
* Amazon

Dependencies

  • Docker

Role Variables

You can change the default variables stored in the defaults/main.yml file. These variables mainly set configuration options. For more details, please check the Lighthouse documentation.

Name Default Value Description
lighthouse_version unset REQUIRED The version of Lighthouse to install and run.
lighthouse_user lighthouse The user for Lighthouse
lighthouse_group lighthouse The group for Lighthouse
lighthouse_base_dir /opt/lighthouse Where to install Lighthouse
lighthouse_config_dir /etc/lighthouse Where to store the default configuration
lighthouse_data_dir /opt/lighthouse/data Where to store the data
lighthouse_log_dir /var/log/lighthouse Where to store logs
lighthouse_log_level "info" The level of logging
lighthouse_log_max_size 25 Maximum size of log files in MB before rotating
lighthouse_log_max_number 14 The number of rotated log files to keep
lighthouse_network mainnet The network configuration
lighthouse_jwt_auth_file "/etc/jwt-secret.hex" Path to the JWT authentication file
lighthouse_enable_doppelganger_protection True Enables doppelganger protection by default
lighthouse_validator_enabled "False" Whether to run as a validator - note that you'll need to copy the secrets and keys yourself
lighthouse_execution_urls "http://127.0.0.1:8551" The execution URL for Lighthouse
lighthouse_validator_beacon_nodes "http://lighthouse-beacon:9596" The beacon endpoint for the validator
lighthouse_checkpoint_sync_url "https://beaconstate-{{lighthouse_network}}.chainsafe.io" URL for checkpoint synchronization to speed up operations
lighthouse_default_fee_recipient "" The default address for fee payments
lighthouse_disable_deposit_contract_sync True Disables deposit contract synchronization for validators
lighthouse_keystores_dir "/config/keys" Directory to store keys for validators
lighthouse_secrets_dir "/config/secrets" Directory to store secrets for validators

Keys/Secrets

You need to place your own secrets and keys in the lighthouse_config_dir you are using.

Example Playbook

  1. Default Setup: Install the role from Galaxy:

    ansible-galaxy install consensys.lighthouse
    

    Create a requirements.yml file with: Replace x.y.z with the version you want to use:

    ---
    - hosts: localhost
      connection: local
      force_handlers: True
    
      roles:
      - role: consensys.lighthouse
        vars:
          lighthouse_version: x.y.z
    

    Run using Ansible:

    ansible-playbook -v /path/to/requirements.yml
    
  2. Install via GitHub:

    ansible-galaxy install git+https://github.com/consensys/ansible-role-lighthouse.git
    

    Create a requirements.yml file with: Replace x.y.z with the version you want to use:

    ---
    - hosts: localhost
      connection: local
      force_handlers: True
    
      roles:
      - role: ansible-role-lighthouse
        vars:
          lighthouse_version: x.y.z
    

    Run using Ansible:

    ansible-playbook -v /path/to/requirements.yml
    

License

Apache

Author Information

Consensys, 2023

Informazioni sul progetto

lighthouse is an open-source ethereum 2 client

Installa
ansible-galaxy install consensys.lighthouse
Licenza
Unknown
Download
1.5k
Proprietario
Consensys is the software engineering leader of the blockchain space. Our full-stack Ethereum products help developers build next-generation networks.