Advanced Features

These features are for advanced users and should be used with caution.

Last updated for DigiNode Tools v26.10.05 (released 20 October 2026). If you are using an older version, some of these features may not be available yet. To update, run diginode-setup and choose Update.

Customize Your DigiNode

The first time that you run DigiNode Setup, it will generate a DigiNode Settings file which is located here: ~/.digibyte/diginode.settings

Before proceeding, you can choose to exit the installer and edit this file to customize your DigiNode Setup. In most cases you should not need to do this, but there are a few reasons why you might want to:

Change the location of your data folder (e.g. to store the blockchain data on a different drive). To do this, change the DGB_DATA_LOCATION variable.
Manually change the maximum connections of your DigiByte Node (default is 150). To do this, change the DGB_MAX_CONNECTIONS variable. Note: You can also change this after installation by editing digibyte.conf directly.
Change how long DigiNode Dashboard runs before it quits automatically (default is 1440 minutes, i.e. 24 hours). To do this, change the SM_AUTO_QUIT variable.
Choose how operating system updates and restarts are handled. See Automatic System Updates below.

You can open the settings file at any time with diginode --settings.

DigiNode Help

Appending the --help or -h flags when running DigiNode Setup will display a list of all the available flags that can be used at launch:

curl -sSL setup.diginode.tools | bash -s -- --help or
diginode-setup --help

You can also do the same when running DigiNode Dashboard:

diginode --help or diginode -h

Unattended Mode

This is useful for installing the script completely unattended. To run in unattended mode, use the --unattended flag at launch.

curl -sSL setup.diginode.tools | bash -s -- --unattended or
diginode-setup --unattended

Note: The first time you run DigiNode Setup in Unattended mode, it will create the required diginode.settings file and then exit. If you wish to customize your Unattended install, you can edit the "Unattended Install" section of this file before proceeding. It is located here: ~/.digibyte/diginode.settings

If you want to skip this step, and immediately begin installing using the default settings, you can include the --skipcustommsg flag:

curl -sSL setup.diginode.tools | bash -s -- --unattended --skipcustommsg or
diginode-setup --unattended --skipcustommsg

Install a Specific Version of DigiByte Core

The --dgbver flag lets you install a particular version of DigiByte Core, to upgrade or downgrade. Only versions that have been verified for your DigiNode can be installed, going back to v7.17.2. Replace 8.26.2 with the version you want:

curl -sSL setup.diginode.tools | bash -s -- --dgbver=8.26.2 or
diginode-setup --dgbver=8.26.2

You can also choose a version from the DigiNode Setup main menu: run diginode-setup and choose Version. You are warned before downgrading to an older major version, which may require the blockchain to be resynced.

Install DigiByte Pre-release

The --dgbpre flag can be used to install the pre-release version of DigiByte Core, if available:

curl -sSL setup.diginode.tools | bash -s -- --dgbpre or
diginode-setup --dgbpre

If you are running a pre-release version of DigiByte, and want to downgrade back to the release version, use the --dgbnopre flag:

curl -sSL setup.diginode.tools | bash -s -- --dgbnopre or
diginode-setup --dgbnopre

(Choose Update from the main menu and it will allow you to downgrade DigiByte Core.)

Automatic System Updates

On Debian, Ubuntu and Raspberry Pi OS, DigiNode Setup can install operating system updates for you automatically, once a day in the background. You are asked once, and can change your choice at any time: run diginode-setup and choose System from the main menu.

Your DigiNode can also restart itself automatically when an update needs a restart to finish (e.g. a new Linux kernel). It only restarts when needed, at the time you choose (04:00 by default), and never while it is busy - for example while DigiNode Setup is running or software is being installed. If it is busy, it tries again later.

These settings are stored in diginode.settings:

SYSTEM_AUTO_UPDATES - SECURITY (security and stability updates, recommended), ALL (all available updates) or OFF.
SYSTEM_AUTO_REBOOT - YES or NO: restart automatically when an update needs it.
SYSTEM_AUTO_REBOOT_TIME - the time to restart, in system time (e.g. 04:00).
For an unattended install, set UI_SYSTEM_AUTO_UPDATES and UI_SYSTEM_AUTO_REBOOT in the "Unattended Install" section.

If you edit these settings in the file, run diginode-setup and choose Update to apply them.

DigiNode Dashboard Commands

DigiNode Dashboard also has commands for managing your DigiByte Node. Enter diginode --help to see the full list. The most useful are:

diginode --dgbrestart / --dgbstop - restart or stop your DigiByte Node
diginode --dgbpeers - list your DigiByte Node's peers
diginode --dgblog - view your DigiByte Node's log file
diginode --listwallets - view the currently loaded DigiByte wallets
diginode --dgbconf - edit digibyte.conf
diginode --settings - edit diginode.settings
diginode --rpc - view your DigiByte Core RPC credentials
diginode --porttest - re-enable the port tests
If you are running a Dual Node, use --dgb2restart, --dgb2stop, --dgb2peers and --dgb2log for the Testnet node.

Manually Locate DigiByte Core

If you wish to use DigiNode Dashboard with your existing DigiByte Node (i.e. one not set up with DigiNode Tools), and the startup checks are not able to locate it automatically, use the --locatedgb flag at launch to manually specify the folder location.

diginode --locatedgb

Skip OS Check

The --skiposcheck flag will skip the OS check at startup in case you are having problems with your system. Proceed with caution.

curl -sSL setup.diginode.tools | bash -s -- --skiposcheck or
diginode-setup --skiposcheck

Skip Package Update

The --skippkgupdate flag will skip trying to update the package cache at launch, in case you do not have permission to do this. (Some VPS won't let you update the package cache.)

curl -sSL setup.diginode.tools | bash -s -- --skippkgupdate or
diginode-setup --skippkgupdate

Skip Hash Verification

Normally, before installing DigiByte Core, the download is verified against its known SHA256 hash, to make sure it has not been tampered with. The hashes are published in the public digibyte-hashes repository on GitHub, and each one is checked against GitHub's own record of the release before it is published. The installation can only proceed if the hash exists and there is a match. This makes sure that only a genuine release of DigiByte Core can be installed. The --skiphash flag will bypass these checks. It is for emergency use ONLY. Do not use this without understanding the risks.

curl -sSL setup.diginode.tools | bash -s -- --skiphash or
diginode-setup --skiphash

Verbose Mode

This provides much more detailed feedback on what the scripts are doing - useful for troubleshooting and debugging. This can be set using the --verbose flag.

curl -sSL setup.diginode.tools | bash -s -- --verbose or
diginode-setup --verbose

Developer Mode

To install the development branch of DigiNode Tools, use the --dgntdev flag at launch. This contains the changes that will be included in the next release.

curl -sSL setup.diginode.tools | bash -s -- --dgntdev or
diginode-setup --dgntdev

To test a new feature before it is released, use --dgntbranch= followed by the name of the feature branch:

diginode-setup --dgntbranch=feature/plugins

Include the flag every time you run DigiNode Setup - otherwise choosing Update will switch you back to the latest release. To go back to the latest release yourself, use --dgntmain.

WARNING: Developer Mode should only be used for testing, may sometimes not run, and could break your DigiNode.

Reset Mode

This will reset and reinstall your current installation using the default settings. It will delete digibyte.conf and diginode.settings and recreate them with default settings, and reinstall DigiByte Core. You can choose whether to also delete your DigiByte blockchain data. Do not run this with a custom install or it may break things. For best results, run a standard update first, to ensure all software is up to date, before running a reset. Software can only be re-installed if it is the most recent version. You can perform a Reset via the DigiNode Setup main menu by entering diginode-setup. You can also use the --reset flag at launch.

curl -sSL setup.diginode.tools | bash -s -- --reset or
diginode-setup --reset

Uninstall

The --uninstall flag will uninstall your DigiNode. You are asked which parts to remove or keep, such as DigiByte Core and the blockchain data. Your DigiByte wallet will be kept. This can also be accessed from the main menu.

curl -sSL setup.diginode.tools | bash -s -- --uninstall or
diginode-setup --uninstall