Dasharo Tools Suite

What is Dasharo Tools Suite?

Dasharo Tools Suite (DTS) is like a swiss army knife for Dasharo firmware: you can execute initial deployment, firmware update and even dump machine logs for debugging and development support.

Also refer to DTS Overview.

How to get Dasharo Pro Package Releases using Dasharo Tools Suite?

Dasharo Pro Package Releases can be used to perform firmware updates with DTS by providing Dasharo Pro Package credentials obtained after buying a Dasharo Pro Package.

Commercial use of DTS should be discussed directly with 3mdeb or Dasharo Team.

How can I use my Dasharo Pro Package credentials

After purchasing the Dasharo Pro Package, you should receive an email with keys to use with Dasharo Tools Suite. This section describes how to do it.

Firstly, run DTS from a USB flash drive, documentation on this is included here.
After booting, you will see a text menu, choose option number 4, Load your DPP keys, by pressing 4 and Enter.
Next, rewrite the credentials received in the following order:
- e-mail,
- password.
Credentials will be verified by DTS attempting to connect to our server. If successful, the message Verification of the Dasharo DPP was successful. They are valid and will be used. will be displayed.

Below is a short demo that presents loading of the DPP keys.

 Dasharo Tools Suite Script 2.6.0
 (c) Dasharo <contact@dasharo.com>
 Report issues at: https://github.com/Dasharo/dasharo-issues
*********************************************************
**                HARDWARE INFORMATION
*********************************************************
**    System Inf.: Emulation QEMU x86 q35/ich9
** Baseboard Inf.: Emulation QEMU x86 q35/ich9
**       CPU Inf.: QEMU Virtual CPU version 2.5+
**    RAM Virtual: Not Specified
*********************************************************
**                FIRMWARE INFORMATION
*********************************************************
** BIOS Inf.: 3mdeb Dasharo (coreboot+UEFI) v0.2.1-rc1
*********************************************************
**     1) Dasharo HCL report
**     2) Update Dasharo Firmware
**     4) Load your DPP keys
**     6) Transition Dasharo Firmware
*********************************************************
R to reboot  P to poweroff  S to enter shell
K to launch SSH server  L to enable sending DTS logs

Enter an option:
4

Enter DPP email:   you@example.com

Enter password:    password
Dasharo DPP credentials have been saved

How to support us?

In general there are three ways to support us:

I have more time than money, and I can code

Please help us develop Dasharo influence on open-source firmware market and spread the word about it. There are multiple ways to do that:

Join Dasharo Matrix Community and support other members of the community.
Join Dasharo open-source firmware. vPub or other related event organized by 3mdeb or Dasharo Team.
Write a Google review.
Follow us on social media and help spreading the word about Dasharo.
Contribute documentation, test results, Dasharo Hardware Compatibility List Reports.

Access to the Dasharo Pro Package (DPP) is granted based on your level of contribution or support for the Dasharo ecosystem. Since Dasharo Tools Suite (DTS) is publicly available, this section refers specifically to access to DPP.

To request access, please contact 3mdeb or Dasharo Team and provide evidence of your contribution or support described below. Each request is evaluated individually. If it would be meaningful, we would be glad to give you access to DPP granted accordingly to your input.

I have more time than money, and I can't code

You can contribute by proposing ideas for new features, reviewing documentation, and helping with testing and validation of bug fixes.

Please see ways you can help us for details.

If you would like to follow that path, contact us on Dasharo - General Matrix channel to agree on the scope of your contribution to avoid any potential collision with other developers.

Once your contribution is completed, contact 3mdeb or Dasharo Team with links or references to your work. Access to the Dasharo Pro Package will be granted for a period and scope adequate to your contribution.

I have more money than time

You may support the project financially by making a donation or purchasing a Dasharo Pro Package via the online store. After completing your donation or purchase, please contact 3mdeb or Dasharo Team to confirm your support.

The scope and duration of DPP access depend on the selected package and current pricing listed in the store.

How can I help the support team diagnose my problem faster?

If you are having issues with functionalities provided by the DTS start menu, you can help by providing logs.

To do that, follow the instructions below:

Boot DTS.
Enable sending logs by pressing L.
Reproduce the problem.
The logs will be sent automatically after exiting from the menu (entering shell, powering off the system or rebooting using the options in DTS menu) or after successful or failed update/install or failed firmware restore.

If you haven't enabled sending logs, then in case of failed update/install/restore you will be asked if you want to send them to 3mdeb:

Do you want to send console logs to 3mdeb? [n/y]: y

Tip

If the automatic log submission does not work in your case, you can view and copy the archive with logs manually from /tmp/logs/*.tar.gz or if the archive wasn't created you can copy logs themselves from /tmp/logs/dts*.log and /var/local/*.log. Depending on your platform configuration and connection method there might be different amount of files e.g.

bash-5.2# ls /tmp/logs/
dts-verbose_tty1.log  dts-verbose_ttyS0.log  dts_tty1.log  dts_ttyS0.log

After collecting or automatically submitting logs, please report the problem by creating an issue on GitHub and/or "Dasharo Premier Support" Matrix channel. If the logs contain sensitive information, such as credentials, please report the issue via email instead.

Make sure to provide details that will help us reproduce the issue, such as the machine model, Dasharo and DTS version, etc., in accordance with the sections of the provided template and in case of automatically submitted logs please also include time and date when those logs were sent.

How can I verify DPP credentials logged in DTS?

After providing credentials and pressing "Enter", select the s option to enter the console. Type the command:

cat /etc/cloud-pass

This command will print two lines. The first line will be the email, and the second will be the password you provided. Verify the lines to ensure they match your credentials.