Skip to content

fhildeb/lukso-node-guide

Repository files navigation

lukso-node-guide

This repository contains all the necessary information to build, set up, and run a node for EVM Proof-of-Stake blockchains, such as LUKSO. It is the essence of running a node at home and should act as a Wiki if you need detailed information about any possible step.

  • 📖 More than 80 Pages of Theory and Best Practice
  • 🌍 Compiled from a dozen Guides, Forums, and Wikis
  • 🚀 Beginner-Friendly Step-by-Step Documentation
  • 📝 Plug-and-Play Grafana Dashboards

If the guide helped you, I would be pleased about a donation: 0xE8DFceC1B3637226f05E6828F56815f6417a6116

Preview

Node Guide Webpage

Description

The repository includes theory pages and guides on network and consensus, validator deposits, node builds, system setups, client installation and configuration, as well as operating staking and monitoring software. Within the archive section, network updates, applied forks, and historical guides are listed. The pages in the repository are split into multiple sections.

⚠️ Pages are for informational purposes only. Contributors do not warrant the guide's accuracy or completeness. Developers shall not be liable for any direct, indirect, incidental, or consequential damages arising out of or in connection with the use of this guide. The disclaimer of warranty also applies to business interruption, data loss, or financial loss.

🧠 Theory

  • preparations: Node and Router Specifications, Network Demand
  • blockchain-knowledge: Proof of Stake, Tokenomics, Peer Networks, Slashing and Penalties, Clients
  • node-operation: Setup Types, OS, Validator Credentials, DDNS, SSH, and VPN, Utility Tools

📖 Guides

  • validator-setup: Device Setup, Key Generation, Launchpad Walkthrough
  • hardware-setup: Node, Router, and Network Setup, BIOS Config, OS Install
  • system-setup: Permissions, Storage Volumes, Updates, Remote Access, and Firewall Setup
  • router-setup: Fetching Device Addresses and Configuring the Address Reservation
  • ssh-setup:Access Properties, Connections, and Authentication Keys
  • client-setup: LUKSO Blockchain Node and Validator Setup
  • modifications: Slasher, Node Name, Graffiti, IP & DDNS, Peer Config, Service Automation
  • monitoring: Node Monitoring for Hardware, Software Clients, and Connections
  • alert-systems: Image Notifications and Constant Mobile Device Updates
  • external-access: Secure External Node Access Configuration
  • maintenance: Tips for Finding and Resolving Node Errors
  • withdrawals: Adding Withdrawals and Exiting Validators

🏛️ Archive

🪞 Templates

  • templates: Grafana Dashboard Presets for LYXt & LYX Staking

Installation

yarn

Enable Caching

  1. Open the docusaurus.config.ts file
  2. Comment out the customWebpackPlugin setup
// function customWebpackPlugin() {
//       return {
//         name: "custom-webpack-plugin",
//         configureWebpack() {
//           return {
//             cache: false,
//           };
//         },
//       };
//     },

Local Runtime

yarn start

Deployment

yarn build

Tools

Credits

About

All-in-One EVM PoS Validator Node Guide for the LUKSO Blockchain

Resources

Stars

Watchers

Forks

Contributors 4

  •  
  •  
  •  
  •