Introduction

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 10 (recommended: Windows 10 2004, 10.0.19041.0 or higher)
  • Windows 11
  • Windows Server 2016 or higher (recommended: Windows Server 2022 or higher)

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

Starting with version 0.2, the eryph App supports Windows 10 Enterprise version 1507 or higher and Windows Server 2016 or higher. However, there are some restrictions on MSIX packages for all versions before Windows 10 2004 and Windows Server 2022. Please refer to the troubleshooting section below for details.

For server versions, we support all versions with enabled Desktop Experience (Standard and Datacenter).

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.

Note

The eryph App is intended to make it easier to get started, create your first catlet, and perform basic tasks. It is not intended to replace a full development UI. We recommend using VSCode as a full UI. The core editor of vscode is embedded in the YAML editor of the eryph App.

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

Error code: installer-0xa0000100

If you see an error like "Windows version is not supported", your Windows version is not supported for the eryph App.
This typically affects all versions before Windows 10 and before Windows Server 2016.

The minimum supported version for the eryph App is Windows 10 1507, 10.0.10240.0. Versions before Windows 10 2004, 10.0.19041.0 may require additional configuration to enable MSIX package installation.
Eryph-zero has lower version requirements and can still be installed using the installation script (see downloads/eryph-zero).

Publisher not trusted

Error codes: msix-0x800b010a, installer-0xa0000203

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.

Sideloading not configured

Error codes: msix-0x800b010a, msix-0x80073cff

When using a version Windows older than Windows 10 2004, you may get errors such as "A certificate chain could not be built to a trusted root authority" or "To install this application you need either a Windows developer license or a sideloading-enabled system".

The eryph app is packaged as an MSIX package and these older versions of Windows require manual configuration to allow the side-loading of MSIX packages.

Please perform the following steps:

  1. Enable side-loading in developer settings of Windows
  2. Install our code-signing certificate in the Local Machine - Trusted Publishers store

Background
All of our packages are signed with a trusted publisher certificate, but versions of Windows older than Windows 10 2004 do not validate the certificate against the trusted root store and instead expect that the publisher's certificate is present in the Trusted Publishers store.

Sideloading not allowed

Error code: msix-0x80073cff

You may get an error such as "To install this application you need either a Windows developer license or a sideloading-enabled system".

If you use Windows 11 or Windows 10 2004 or newer, this error indicates that the side-loading of MSIX packages has been explicitly disabled or you might be running Windows in S mode.

Enterprise Environments
In some organizations, the side-loading of MSIX packages might be restricted by policies. If this is the case, please contact your IT administrator team for assistance.

Windows Firewall service is not running

Error code: msix-0x80073d0a

It is a requirement by Microsoft that the firewall service is in status running to install applications as "Apps" (MSIX packages). Make sure the Firewall Service is running. You can turn off the firewall itself, but the service must be running.

Downgrade not possible

Error code: msixcore-0x80073d06

Sometimes, the installation might fail when you try to install an older version of the eryph App and a newer version is already installed. In this case, please manually uninstall the newer version of the app first.

Previous
eryph-zero
Next
Using Powershell