There must exist information to recover the UI admin account at this exact URL, which is hardcoded in the UI
https://dappnode.github.io/DAppNodeDocs/troubleshooting/#recover-password

If the user has lost both the password and the recovery token, to recover admin access:

1. SSH into the DAppNode host or plug a keyboard
2. Run

cat /usr/src/dappnode/DNCORE/admin-recovery-token.txt

Use the token to restore the account

It would be nice to have in the docs what keywords you can use on the docker-compose file when you are using the dappnodesdk.

This content can be found on the file

https://github.com/dappnode/DNP_DAPPMANAGER/blob/7b9ad9ad556a24875ed222bd07fec2c9d3e8c568/packages/dappmanager/src/modules/compose/unsafeCompose.ts#L34

Describe the bug

After doing yarn build and npm run serve, the path is not set up correctly in the package.json

To Reproduce

The endpoint of the Local Proxy should be http://dappnode.local instead of https://dappnode.local

The link to install with a script from here is broken https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/

Describe the bug

When opening this page directly:
https://docs.dappnode.io/user-guide/ui/recommended-set-ups/add-vpn-devices/

The images do not show.

From Chrome latest and iOS Safari v15.4

To Reproduce

1. Click on this link: https://docs.dappnode.io/user-guide/ui/recommended-set-ups/add-vpn-devices/

Expected behaviour

The image should show up correctly.

Screenshots

DAppNode version:

• not relevant -

Additional context

It looks like if you are navigating on the website and coming from another page, the image will show. But if you access the page directly or refresh the page, then the images won't show.

I recommend to use /img/XXXX instead of ../../../img/

You can see from the source that the images src are not consistent. Sometimes it uses ../../../../img and sometimes it uses ../../../img

This image seems to also be impacted:
https://github.com/dappnode/DAppNodeDocs/blob/master/docs/user-guide/ui/access/vpn.md?plain=1#L32

A PR has been created here:
#150

Page link:
https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/

Install with script link:
https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/script

Describe the bug

Both links to "Installing with a script" and "Installing with an ISO" on the overview page are broken. Links from the menu still work

To Reproduce

1. Navigate to https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/
2. Click on "Installing with a script" or on "Installing with an ISO"
3. Page not found error is shown

Expected behavior

Should redirect to the correct pages which work from the menu:

• Installing with an ISO should link to https://docs.dappnode.io/get-started/installation/custom-hardware/installation/iso
• Installing with a script should link to https://docs.dappnode.io/get-started/installation/custom-hardware/installation/script

The docs navbar has the default blue color. We should change it to DAppNode's accent color which is exactly #2fbcb2 or otherwise a similar flavor or cyan would work.

Describe the bug

There is an edit page button in the bottom part that redirects to nowhere.

To Reproduce

This button should not be there. People will not edit the docs from UI.

Describe the bug
Missing links.
https://docs.dappnode.io/get-started/user-guide/ui/access/local-proxy
https://docs.dappnode.io/get-started/user-guide/ui/access/vpn#wireguard
https://docs.dappnode.io/get-started/user-guide/ui/access/vpn#openvpn
https://docs.dappnode.io/get-started/user-guide/ui/access/local-proxy

From this page
https://docs.dappnode.io/get-started/installation/custom-hardware/installation/script/

These links are broken.
Local Proxy
Wifi
Wireguard
OpenVPN

To Reproduce

Expected behavior

Doc page should load.

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

Wrong link on page : https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/

Long term issue to be linked in the future to the UX redesign

Update the content on the new documentation:

• intro.md Welcome page to documentation
• get-started section, the introduction

Add documentation for the commands available in the dappnode host:

• dappnode_wifi
• dappnode_connect
• dappnode_wireguard (with --qr --local flags)

More info on aliases in profile: https://github.com/dappnode/DAppNode_Installer/blob/master/.dappnode_profile

Depends on:

• dappnode/DNP_DAPPMANAGER#955
• dappnode/DNP_DAPPMANAGER#963
• dappnode/DAppNodeSDK#190

There current beaconchain driver named ethereum2-beacon-chain-prysm will be renamed to ethereum-beacon-chain and it will be available for all future eth2 clients: Teku, Prysm, Lighthouse, Nimbus...

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

Describe the bug

See https://discord.com/channels/747647430450741309/755613415677886514/826526779488337931

Someone needs to update the DAppNode Minimum Requirements on this page:
https://dappnode.github.io/DAppNodeDocs/install/
It currently says: "We recommend having at least 4GB RAM (ideally 8GB+) and an SSD hard drive with at least 256GB (add capacity as you like, keep in mind that only Ethereum mainnet is 180GB at press time)." and that is woefully inadequate these days.

Add CI tools to improve doc checking. See https://www.writethedocs.org/guide/tools/testing/

Implementation example https://github.com/ConsenSys/doc.teku/blob/master/.circleci/config.yml

Describe the bug

As a first-time user, I need to follow the recommended "First steps..." However, the link is broken.

To Reproduce

From https://docs.dappnode.io/get-started/installation/dappnode-hardware/installation/
Click on https://docs.dappnode.io/get-started/first-steps

Expected behavior

To display the first steps on how to configure my DAppNode

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

There should be added documentation to the docs for how to adding metrics to and dashboards to be used by the DMS package

We are moving all the content of the wiki to the docs, the information has been passed. Now we need to update the old links to avoid the user is redirected to the wiki.

Currently to develop with the mkdocs repository is needed a wide range of requirements, to speed up this process a docker integration would improve the development process.

Context

When developing a DAppNode package, not all docker-compose keys are supported, there is a parseSafeCompose function in the dappmanagfer that uses whitelisted keys to be used.

Feature request

Consider adding documentation for this whitelisted keys, especially useful for developers.
Take into account this issue dappnode/DNP_DAPPMANAGER#978

• Create guide.dappnode.io
• Move User guide to new subdomain

Edit: New approach being documented below.

Describe the bug

When a user installs dappnode in raspberry pi and wants to use an SSD, dappnode does not detect it automatically, how to add this SSD is on the documentation in the FAQ sections, but for arm, users are something so basic, it would be a good idea to add this information on the basic installation.

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

​---
​sidebar_position​: ​3
​---

​#​ ​Script Installation

​You can install DAppNode using the installation script. In this case, we recommend you use Ubuntu or Debian as your operating system.

​##​ ​Prerequisites

​Before installing DAppNode, you need to install some prerequisites:

​-​ ​Docker​
​-​ ​Docker-compose​
​-​ ​xz​

​To install all the above prerequisites, execute the command below in the terminal of the machine you want to install DAppNode. If you already have the dependencies installed or you want to install them on your own you can skip this step.

​sudo wget -O - https://prerequisites.dappnode.io | sudo bash

​##​ ​Installation

​To install DAppNode, install it executing the next script:

​sudo wget -O - https://installer.dappnode.io | sudo bash

​##​ ​Reboot

​To finalize the installation once it has finished completing, reboot your machine:

​shutdown -r now

​##​ ​Post-Installation

​Once the installation process has finished, DAppNode will try to automatically prepare the first access to your DAppNode on the next order:

​1.​ ​Local Proxy​
​2.​ ​Wifi​
​3.​ ​Wireguard​
​4.​ ​OpenVPN​

​##​ ​Restore to the latest version from a script

​If you are experiencing any problem or just want to make sure you are running the latest DAppNode versions, execute this command in the DAppNode terminal. This will update the core packages to the latest versions without erasing any data from your volumes.

​sudo wget -O - https://installer.dappnode.io | sudo UPDATE=true bash
, , ,

There is a problem with the dependencies of mkdocs material: ymdown-extensions and markdown. Due to this issue, Pip install the last version of these 2 dependencies, the problem is that version is not compatible with the mkdocs dependencies.

It would be a good idea include in the README.md an easy guide to install. I found the solution on that issue link, it consists of installing the required version which mkdocs-material require avoiding pip install the last and incompatible version.

Context

Due to the new feature implemented in dappnode to increase the dappnode host filesystem with a storage device, it is necessary to explain how to reinstall dappnode if there was performed a extension whrough LVM

• In the disk partitions select manual configuration
• Choose configure LVM
• Defined all the options available, recommended to delete all LVM

The Recommended setup part is outdated. The process now is automatic. Another problems and doubts can appear like:

• Username/password created by default.
• Wrong language keyboard configuration.

Describe the solution you'd like
Actualizing the guide with the actual steps you have to follow, inform about de user/password by default.

This PR dappnode/DNP_DAPPMANAGER#783 adds a view that references https://docs.dappnode.io/connect/#via-local-proxy

There must exist docs there before the DAPPMANAGER release. If you want to change the URL or title of the section, please do it and then do a PR to the DAPPMANAGER

Is your feature request related to a problem? Please describe.

Describe the solution you'd like

Describe alternatives you've considered

Additional context

Users consuming the docs would benefit greatly from a search bar for quickly consuming content.

Docusaurus support search bars for free, see https://docusaurus.io/docs/search

While the telegram guide to get the bot telegram is ok, we should add a bigger guide with screenshots about the whole process. Then add the link to the UI in the notifications view

@branciard **

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

See dappnode/DAppNodeSDK#191

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

Describe the bug
On this link: https://docs.dappnode.io/first-steps
In this line: This configuration can be modified whatever you want. You can find all the information with all the details about this decision in this section.

The word section links to https://docs.dappnode.io/first-steps/first-steps which does not exist.
I think it should link to https://docs.dappnode.io/user-guide/ui/initial-configurations/select-a-client

It could be a good idea to add a section called "our packages" where we can have an explanation of some packages, what they are or how they work on dappnode. This content would help a lot to the users to understand and follow features how for example the next feature we will release like web3signer + Eth 2.0 client, how it works and what is it and more info.
This content can have more information about more packages.

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

Describe the bug
Broken link: https://docs.dappnode.io/get-started/installation/custom-hardware/installation/overview/iso

Having a preview on PRs is fucking awesome, can we have it here too?

As long as the DMS package is an important package for the users and the grafana documentation can be overwhelming for users who are not used to working with this kind of program, it could be good to have a dedicated space in the documentation for some grafana configurations.
Some content like this one https://forum.dappnode.io/t/begginer-friendly-install-monitoring-system-on-dappnode-using-dms-package/623
, furthermore, it would be interesting adding more information in order to clarify some behaviour of grafana in dappnode like (dappnode/DAppNodePackage-DMS#30)

https://docs.dappnode.io/get-started/installation/custom-hardware/installation/iso/

Local Proxy link at bottom is pointing to : https://docs.dappnode.io/get-started/user-guide/ui/access/local-proxy

Oh oh... You probably weren't looking for this.

Describe the bug

To Reproduce

Expected behavior

Screenshots

DAppNode version:

• Package version:
• OS:
• Browser

Additional context

Many users have asked about how to expose some endpoints of X package. This is possible to do it manually using the UI, it should be nice to explain this feature in more detail. Currently, we only explain how to use the default ports that are configurated to be exposed.

The "Custom Hardware" link is broken

In the "Custom Hardware" section the "Custom Hardware", https://docs.dappnode.io/get-started/installation/introduction/introduction, link on the "Introduction" page, https://docs.dappnode.io/get-started/installation/introduction, and it yeilds:

"Oh oh... You probably weren't looking for this.
We've changed the documentation to serve you better and we might have broken this link.

If you got here following one of our links, please report the broken link here.

Back to homepage"

Also in the "Arm Hardware" section the "Custom Hardware", https://docs.dappnode.io/get-started/installation/introduction/arm-hardware/hardware-recommendations, yields the same 404 as above.

To Reproduce

1. Click on https://docs.dappnode.io/get-started/installation/introduction/introduction

or

1. Click on https://docs.dappnode.io/get-started/installation/introduction/arm-hardware/hardware-recommendations

Expected behavior

Both should go to the real "Custom Hardware" page

Hi, Dappnode community!

I came across your project and was going to install and test it locally when I sadly discovered that the links on your webpage regarding installation instructions (both with script and ISO) are not working

Thank you for your time