Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/dao.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: DAO
description: DAO information
llm_description: "Dappnode DAO governance overview: NODE token addresses, mission, Snapshot voting, and ValidatorDAO."
---

:::danger Documentation alert
Expand Down
1 change: 1 addition & 0 deletions docs/dao/faq.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Dappnode DAO FAQ
llm_description: FAQ explaining what a DAO is and Dappnode DAO's mission for decentralized infrastructure.
---
<details>
<summary><b>What is a DAO?</b></summary>
Expand Down
5 changes: 5 additions & 0 deletions docs/dao/liquidity-mining.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
title: Liquidity Mining
llm_description: "NODE liquidity mining program details: pool allocations, contract addresses, and weekly rewards."
---

# Liquidity Mining

Liquidity Mining (LM) launched on Jul 17 2021, 20:00:00 GMT. 5.5% of the total token supply, 5.5 Million NODE, has been allocated to the first LM round of 6 months. NODE reward distribution for the 4 pools available is as follows:
Expand Down
5 changes: 5 additions & 0 deletions docs/dao/node-basics.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
title: The NODE Economy
llm_description: "NODE token economics: 100M supply distribution, NODEdrop recipients, and NODEstream vesting."
---

# The NODE Economy

### NODE Basics
Expand Down
5 changes: 5 additions & 0 deletions docs/dao/node-drop.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
title: NODEdrop
llm_description: NODEdrop airdrop program for early Dappnode supporters and community members.
---

# NODEdrop

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
5 changes: 5 additions & 0 deletions docs/dao/node-stream.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
title: NODEstream
llm_description: NODEstream vesting program for gradual token distribution to participants.
---

# NODEstream

"Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
1 change: 1 addition & 0 deletions docs/dev.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
sidebar_label: Introduction
llm_description: "Introduction to Dappnode developer docs for creating, deploying, and managing custom packages."
---

# Welcome to the Developer Documentation!
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/dns.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "DNS-based service discovery and domain naming conventions for DAppNode packages."
---

# 🌐 DNS

By default, every DAppNode package runs on Docker networks that provide DNS-based service discovery. The main network is `dncore_network`, which uses a public IP range, and starting from core version 0.3.2, there is also a `dnprivate_network` with the private IP range `10.20.0.0/24`. Both networks allow packages to communicate and resolve service names, but `dnprivate_network` adds a security layer by restricting access to a private IP range, making it ideal for accessing sensitive UIs and services.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/github-actions.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "GitHub Actions workflows for automating upstream updates and package releases."
---

# GitHub Actions for Dappnode Packages

GitHub Actions help automate workflows around your projects on GitHub. For Dappnode packages, we utilize specific GitHub Actions to manage updates and releases.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/metrics.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Prometheus and Grafana metrics framework for DAppNode packages via DMS."
---

# 📊 Package Metrics

DAppNode supports an integrated metrics framework based on [Prometheus](https://prometheus.io/) and [Grafana](https://grafana.com/), powered by the [DMS package](https://docs.dappnode.io/docs/user/packages/dms/).
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/notifications.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Notification system for alerting users about events via the DAppNode UI."
---

# 🔔 Package Notifications (Coming soon)

Notifications are a way to inform users about events happening in the DAppNode. They are displayed in the [notifications tab](http://dappmanager.dappnode/notifications) within the DAppNode UI. Notifications are sent by third-party software, "Gatus," which monitors the services running in the DAppNode or arbitrary services that send notifications. Users can configure the notifications they want to receive and set thresholds (if applicable) for these notifications.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/package-development/multi-configuration.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Guide for developing multi-variant packages supporting different networks from one codebase."
---

# Multi-Config Package Development

This guide will walk you through the steps to develop a multi-config Dappnode package, allowing you to create multiple package configurations from a single source. We'll use the Lodestar Generic package as a reference, which builds multiple variants for different networks like Mainnet, Holesky, and Gnosis.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/package-development/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Overview of single-config and multi-config package repository types."
---

# Package Development

Welcome to the **Package Development** section! This guide will help you create your own Dappnode packages. In Dappnode, packages are applications that you can download and install on your Dappnode machine, allowing you to enhance its functionality.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/package-development/single-configuration.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Step-by-step guide for developing single-variant Dappnode packages."
---

# Single-Variant Package Development

This guide will walk you through the steps to develop a single-variant Dappnode package using a simple example. We'll start with initializing a basic package and progress to a more complex setup, using the Holesky Geth package as a reference.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/package-publishing/package-ownership.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Role permission system for managing package ownership via Aragon ACL contracts."
---

# Package Ownership

This guide outlines the role permission system used in Dappnode package management, powered by Aragon’s ACL (Access Control List) smart contracts. It explains how to check and modify roles such as permission managers and developers.
Expand Down
2 changes: 1 addition & 1 deletion docs/dev/package-publishing/publish-packages-clients.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Publish your packages seamlessly

llm_description: "Step-by-step guide for publishing packages using the SDK-publish UI."
---

# Publish your packages seamlessly
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/references/docker-compose.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Reference for docker-compose.yml structure, environment variables, and build arguments."
---

# Docker compose file

Dappnode packages are built upon Docker containers. The heart of defining how these containers run and interact lies in the `docker-compose.yml` file. In this guide, we will explain the typical structure of the `docker-compose.yml` file for a Dappnode package.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/references/manifest.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Complete reference for dappnode_package.json manifest file properties."
---

# Dappnode Package (DNP) manifest

The Dappnode Package manifest defines all the necessary information for a Dappnode to understand this package:
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/references/notifications.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Schema reference for notifications.yaml configuration using Gatus endpoints."
---

# Notifications File Reference (Comming soon)

This document serves as a reference for the Notifications configuration file in DAppNode. It defines the structure, fields, and expected values based on the [JSON Schema](https://github.com/dappnode/DAppNode/raw/schema/notifications.schema.json).
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/references/setup-wizard.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Reference for setup-wizard.yml to customize package installation with forms."
---

# Wizard Reference

The setup wizard for Dappnode packages helps automate the package customization and improve its user experience. You can allow users to conveniently edit environment variables, port mappings, and upload files while interacting with a simple web form, right before installing the package.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/sdk/commands.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Documentation for SDK init, build, and publish commands with options."
---

# Main commands

This page covers the top three functionalities of DappnodeSDK: `init`, `build`, and `publish`. Each command plays a crucial role in the development and deployment process of dappnode packages (DNPs).
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/sdk/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Overview of DappnodeSDK tool for creating, building, and publishing packages."
---

# DappnodeSDK

The DappnodeSDK `dappnodesdk` is a tool that makes creating and publishing new Dappnode packages as simple as possible. It helps to initialize, build, test, and publish the new package/repo to an APM tracked on the Ethereum Mainnet.
Expand Down
4 changes: 4 additions & 0 deletions docs/dev/sdk/sdk-publish.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Guide for using SDK-Publish tool to sign and publish package releases."
---

# SDK-Publish

The SDK-Publish tool is a component of the Dappnode Software Development Kit (dappnodesdk). This tool simplifies the process of signing and publishing Dappnode package releases, utilizing your wallet for secure and efficient transaction management.
Expand Down
1 change: 1 addition & 0 deletions docs/smooth.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: Smooth
description: Smooth introduction
llm_description: Introduction to Smooth, Dappnode's MEV Smoothing Pool for consistent solo staker rewards.
---

# Welcome to Smooth, Dappnode's MEV Smoothing Pool!
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/deep-dive-into-smooth/consolidations.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: How Smooth handles Pectra validator consolidations and transfers pending rewards automatically.
---

# Consolidations

Since the [Pectra](https://ethereum.org/en/history/#pectra) update on May 7, 2025, validators can stake up to 2048 ETH. Instead of having to manage multiple 32 ETH validators, users can now choose to stake an arbitrary amount of ETH in a single validator.
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/deep-dive-into-smooth/oracle-sm.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: Explains Smooth's Oracle and Smart Contract architecture for tracking validators and rewards.
---

# Smooth's architecture

[Smooth](https://smooth.dappnode.io/) is composed of two main components: the **Oracle** and the **Smart Contract**. These two components work together to track validators and distribute rewards fairly. Both are open source and indispensable to the functioning of [Smooth](https://smooth.dappnode.io/). While the Smart Contract serves to track all the events related to the pool onchain (subscriptions, unsubscriptions, block proposals, etc.), the Oracle is responsible for computing the rewards of each validator.
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/deep-dive-into-smooth/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: Index page linking to deep-dive sections on rewards, validator states, and architecture.
---

# Deep Dive into Smooth!

In this section, you will find an in-depth explanation on how [Smooth](https://smooth.dappnode.io/) works. This includes its different components, all states possible of a subscribed validator, and much more!
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/deep-dive-into-smooth/rewards.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: How Smooth distributes rewards based on effective balance and converts pending to claimable.
---

# Rewards

Receiving and distributing rewards is one of the core functionalities of [Smooth](https://smooth.dappnode.io/). In this section we will explain how rewards are handled by [Smooth](https://smooth.dappnode.io/) and how they are distributed to validators, as well as how users can claim their rewards.
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/deep-dive-into-smooth/states.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Validator state machine: Active, YellowCard, RedCard, NotSubscribed, Banned, and Untracked."
---

# Smooth Validator States

A [Smooth](https://smooth.dappnode.io/) validator can be in multiple states depending on its behavior. In this section we will explain all possible states a validator can have, the consequences of being each state, and how a validator can transition from one state to another.
Expand Down
2 changes: 1 addition & 1 deletion docs/smooth/deep-dive-into-smooth/vanilla-blocks.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: What is a vanilla block?

llm_description: Explains vanilla blocks and why MEV blocks are required; 3 vanilla blocks leads to ban.
---

**What is a vanilla block?**
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/faq-glossary.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: FAQ about fees, claiming rewards, and glossary of terms like pending/accumulated rewards.
---

# FAQ & Glossary

## FAQ
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/subscribe-to-smooth/automatic.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: Auto-subscribe by setting fee recipient to Smooth address and proposing a block.
---

# Automatic Subscription

This is the simplest way to subscribe to [Smooth](https://smooth.dappnode.io/). It consists of changing the fee recipient of your validator to Smooth's address and subscribing automatically when proposing your next block.
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/subscribe-to-smooth/manual.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: Manual subscription via website with 0.01 ETH deposit to start earning immediately.
---

# Manual Subscription

Would you rather not wait until your next proposed block to subscribe and begin earning rewards? You can take a proactive step and opt for manual subscription right away. During this process, you'll change your validator's fee recipient to Smooth's address, just like in the automatic subscription. However, instead of waiting for your next proposed block, you'll immediately start accumulating rewards from [Smooth](https://smooth.dappnode.io/).
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/subscribe-to-smooth/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Overview of two subscription methods: automatic and manual, with address info."
---

# Subscribing to Smooth

Hello! In this section you will find all the information on how to subscribe your Validators to [Smooth](https://smooth.dappnode.io/). Even though the process is simple, it is important to follow the steps carefully.
Expand Down
4 changes: 4 additions & 0 deletions docs/smooth/unsubscribe-from-smooth.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: How to unsubscribe via website; warns that pending rewards are lost on exit.
---

# Unsubscribing from Smooth.

Unsubscribing from [Smooth](https://smooth.dappnode.io/) is as simple as subscribing to it. You can unsubscribe from [Smooth](https://smooth.dappnode.io/) at any time, it is done through **[Smooth's website](https://smooth.dappnode.io/)** and it only takes one simple transaction.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/local.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Access Dappnode via http://dappnode.local on same network; limited to Admin UI dashboard only."
---

# Local Proxy Access to Dappnode

The local proxy method provides a way to access your Dappnode from within the same local network without any previous configuration required. However, it's essential to understand that due to certain network incompatibilities, this method might not work for all users.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Overview of four ways to access Dappnode: WiFi, VPN, Local Proxy, and Terminal."
---

# 🌐 Access your Dappnode

Dappnode is made to work on a dedicated computer, and its main control panel, the **Dappmanager**, is accessed from another device via [my.dappnode](http://my.dappnode/) , as it is meant to be installed over an operating system that does not include a graphical interface.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/terminal.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Advanced CLI access via SSH or physical terminal for deep control and management."
---

# Terminal Access to Dappnode

Accessing the terminal of your Dappnode, often referred to as the command-line interface (CLI), provides deep control and management capabilities. However, this method is considered advanced and requires familiarity with command line interactions. Incorrect or misguided commands can lead to unintended changes or potential system damage.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/vpn/openvpn.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Setup guide for OpenVPN access with credential retrieval and multi-platform installation steps."
---

# OpenVPN Access to Dappnode

OpenVPN is a widely-accepted VPN protocol known for its reliability and high-security standards. Here's how you can set it up with Dappnode.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/vpn/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Overview of VPN options (Tailscale, WireGuard, OpenVPN) for secure local and remote access."
---

# VPN Access to Dappnode

Virtual Private Network (VPN) is a robust method for accessing your Dappnode. It ensures a secure and encrypted connection between your device and the Dappnode, allowing you to manage your Dappnode from virtually anywhere. Depending on your needs and preferences, Dappnode offers support for two primary VPN technologies: **WireGuard** and **OpenVPN**.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/vpn/tailscale.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Setup Tailscale VPN for easy access without port forwarding; solves UPnP and CGNAT issues."
---

# Connect to Your Dappnode Using Tailscale

Tailscale is a secure, peer-to-peer VPN solution that simplifies connecting to your Dappnode without requiring complex port forwarding, solving issues such as UPnP not being recognized, routers behind CGNAT, or other port forwarding challenges. This guide walks you through setting up Tailscale to access your Dappnode.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/vpn/wireguard.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "WireGuard VPN setup guide with credential retrieval and multi-platform client configuration."
---

# WireGuard Access to Dappnode

WireGuard is a modern, high-performance VPN protocol that offers a simple and streamlined approach for securely accessing your Dappnode. This guide will walk you through setting up WireGuard with your Dappnode.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/access-your-dappnode/wifi.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Connect to Dappnode via built-in WiFi hotspot (SSID: DappnodeWIFI, password: dappnode)."
---

# Wi-Fi Access to Dappnode

If you bought a Dappnode from our store, or installed Dappnode on a computer with a built-in Wi-Fi chip, you can easily connect to the **Dappmanager** (Dappnode web UI) using the Dappnode's Wi-Fi hotspot.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/dappnode-app/how-to-install.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Step-by-step guide to install Dappnode PWA app on mobile/desktop with VPN and notifications."
---

# How to install the Dappnode app

The complete process to install the Dappnode app is the following:
Expand Down
4 changes: 4 additions & 0 deletions docs/user/dappnode-app/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Dappnode PWA app for mobile/desktop: remote management, notifications, and staking configuration."
---

# Overview

The **Dappnode app** is a new form of interaction with Dappnode from **mobile and desktop devices**. It helps users to enter the Dappmanager remotely and get notified about the hardware status and the staking performance.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/dappnode-cloud/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Deploy Dappnode in cloud (AWS) without hardware; ideal for testing, dev, or short-term use."
---

# What is Dappnode Cloud?

Dappnode Cloud is a service that allows users to deploy a Dappnode in a cloud provider so it can be tested without the need for physical hardware. We provide easy pre-configured instances for the main cloud providers (AWS for now, more to come later) to continue to make the deployment of web3 infrastructure accessible and hassle-free for everyone. It consists of a Dappnode image deployed on a machine instance from a cloud provider, eliminating the need to invest in hardware in order to test Dappnode.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/dappnode-cloud/providers/aws/faqs.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "AWS FAQs: machine selection, storage requirements, security groups, Telegram setup, troubleshooting."
---

# FAQs & Troubleshooting

<details>
Expand Down
5 changes: 5 additions & 0 deletions docs/user/dappnode-cloud/providers/aws/overview.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,8 @@
---
title: AWS
llm_description: "AWS overview: Dappnode AMI at $15/month plus AWS infrastructure costs (pay-as-you-go)."
---

# AWS

Amazon Web Services (AWS) is a cloud computing platform provided by Amazon. It offers a wide range of services, including computing power, storage options, and networking capabilities, enabling users to build and deploy applications and services efficiently.
Expand Down
4 changes: 4 additions & 0 deletions docs/user/dappnode-cloud/providers/aws/set-up-instance.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,7 @@
---
llm_description: "Step-by-step guide to launch Dappnode on AWS EC2 with Telegram or SSH credential retrieval."
---

# How to Set Up an Instance

To launch a Dappnode AMI instance, follow these steps:
Expand Down
Loading