eryph App

The eryph App is the central tool for working with eryph on desktop computers.

Installation

You can install the eryph App either from the Microsoft store (recommended) from our standalone installer. See downloads for all installation options.

Supported Windows Versions

The eryph App can be installed on x64 Versions of

• Windows Server 2022
• Windows Server 2025
• Windows 10 (min: Win10 2004, 10.0.19041.0)
• Windows 11

For Server Versions we support all version with user experience enabled (Standard/Datacenter).

The eryph App also supports Windows Home, however on Windows Home eryph-zero cannot be installed. Therefore you can only use the eryph App on Windows home to connect to a another eryph instance.

Sideloading

The eryph App can also be installed via sideloading in enterprise environments. On the downloads page you can find both appinstaller and msixbundle files. Please note that for sideloading to work correctly, you must also add the root certificate and intermediate certificate of our signing certificate to the trusted publisher store.

If you want to allow automatic updates for sideloaded installations, use the appinstaller file. Otherwise, you can use the msixbundle file, but you will have to manage updates manually.

Using the eryph App

The eryph app can be used to install and update eryph-zero, eryph-packer, and the eryph Powershell cmdlets.
It also supports performing basic management operations on catlets from its user interface.

Installing Applications

Within the eryph App you can manage the installation of all eryph components. Just select a component and install it. During the installation you may need administrator rights.

The eryph App also regulary checks for updates of installed components and notifies about pending updates.

Manage Catlets

The eryph App can connect to a local or remote eryph compute instance and allows you to manage catlets on this instance. This includes the following features

• create catlets from a wizard or YAML file
• update catlet via YAML file
• start / stop / delete operations on catlets
• connect to catlet via RDP or VMConsole

Most operations performed on catlets are delegated to the corresponding commands of the PowerShell client.

Troubleshooting

In case you have a error installing or using the Eryp App that is not documented below, please check following support options:

Communities:
GitHub: https://github.com/orgs/eryph-org/discussions
Reddit: https://www.reddit.com/r/eryph/

Support ticket:
In addition, while still in early beta, we also offer the option to submit support requests directly to our support website https://support.dbosoft.eu or via email support@dbosoft.eu.
Please use this option only if you do not want to disclose your support request, as issues posted in the communities may help others to solve their problems.

Installation failed

If the eryph app installation from the standalone installer fails, it should also have opened a text file that contains some logging. Please check the information in the log and the support options above for further assistance.

Windows version is not supported

If you see an error like "Windows version is not supported", your Windows 10 version is not supported for the eryph App.
This typically affects long-term enterprise versions of Windows 10 (e.g. 1809 / 10.0.15063.0) and Windows Server 2016/2019.

The minimum supported version for the eryph App is Windows 10 2004, 10.0.19041.0. Eryph-zero has lower version requirements and can still be installed using the installation script (see downloads/eryph-zero).

Publisher not trusted

You may get an error such as "Publisher not trusted" or "A certificate chain could not be built to a trusted root authority."

Since all of our packages are signed with a trusted publisher certificate, you are most likely running into a problem caused by the way Microsoft updates trusted publisher certificates.

Try the following solutions first:

• Make sure you have a working Internet connection while installing the eryph App.
• Repeat the installation if it failed the first time.
• Use the Microsoft Store package (may be disabled in enterprise environments)

Background

Microsoft no longer provides a static list of trusted publishers. Instead, they are downloaded on demand when a package is installed. If you are offline or the Microsoft servers are unreachable, the trusted publishers will not be updated.

Enterprise Environments

In some organizations, the Trusted Publisher update is configured to run in an offline mode. If this is the case, please contact your IT administrator team for assistance. See also Sideloading installation options above.