Troubleshooting

UI5 Server

Chrome Redirects HTTP URLs to HTTPS (ERR_SSL_PROTOCOL_ERROR)

An HTTPS server or proxy that was previously running on a domain (e.g. localhost), might have set an HSTS header, enforcing Chrome to always use HTTPS for this domain. See https://www.chromium.org/hsts. This makes it impossible to connect to an HTTP-only server running on the same domain.

Resolution

You need to delete the HSTS mapping in chrome://net-internals/#hsts by entering the domain name (e.g. localhost) and pressing "delete".

Issues Not Listed Here

Please follow our Contribution Guidelines on how to report an issue.

UI5 Project

~/.ui5 Taking too Much Disk Space

UI5 CLI stores several kinds of data under your user's home directory in ~/.ui5/:

Directory	Contents	Safe to delete?
~/.ui5/framework/	Downloaded UI5 framework dependencies (one copy per version)	Yes — re-downloaded on next invocation
~/.ui5/buildCache/	Build cache used by ui5 build and ui5 serve (see Build Cache Control)	Yes — rebuilt on next ui5 build / ui5 serve
~/.ui5/server/	Locally generated SSL certificate and private key for HTTPS / HTTP/2 mode	Yes — regenerated on next HTTPS server start; the new certificate must be re-trusted

WARNING

Only remove these directories when no UI5 CLI process and no @ui5/* API consumer is actively running. Deleting files that are in use can cause running builds or servers to fail or produce inconsistent results.

Resolution

To free disk space, remove the relevant subdirectory.

To only remove framework downloads:

rm -rf ~/.ui5/framework/

To only remove the build cache:

rm -rf ~/.ui5/buildCache/

INFO

If you have configured a custom data directory via UI5_DATA_DIR or ui5 config set ui5DataDir, replace ~/.ui5/ with that path. See Changing UI5 CLI's Data Directory.

Environment Variables

Changing the Log Level

In CI environments or in a combination with other tools, the usage of UI5 CLI's --log-level command parameter might be inconvenient and even impossible.

Resolution

Replace UI5 CLI's --log-level option with the UI5_LOG_LVL environment variable.

Example:

UI5_LOG_LVL=silly ui5 build

On Windows:

set UI5_LOG_LVL=silly ui5 build

Cross Environment via cross-env:

cross-env UI5_LOG_LVL=silly ui5 build

UI5 + Karma:

cross-env UI5_LOG_LVL=verbose npm run karma

WARNING

The combination of the UI5_LOG_LVL environment variable with the --log-level CLI parameter might lead to unexpected results; they should be used interchangeably but not together. The CLI parameter takes precedence over the UI5_LOG_LVL environment variable.

Disabling Interactive ui5 serve Output

When ui5 serve runs in an interactive terminal, it can render a live status banner instead of plain log output.

Resolution

Set the UI5_CLI_NO_INTERACTIVE environment variable to any value to force plain output.

Unix:

UI5_CLI_NO_INTERACTIVE=1 ui5 serve

Windows:

set UI5_CLI_NO_INTERACTIVE=1 ui5 serve

Cross Environment via cross-env:

cross-env UI5_CLI_NO_INTERACTIVE=1 ui5 serve

Changing UI5 CLI's Data Directory

UI5 CLI's data directory is by default at ~/.ui5. It's the place where the framework artifacts are stored. In some cases and environments this is not a convenient location and the user needs to provide a better one.

The path to it can either be provided via environment variable or permanently set in the configuration.

INFO

Paths are resolved relative to the current root project path (i.e. where the package.json is located).

Environment variable UI5_DATA_DIR

Unix:

UI5_DATA_DIR=/my/custom/location/.ui5 ui5 build

Windows:

set UI5_DATA_DIR="C:\\my\\custom\\location\\.ui5" ui5 build

Configuration ui5DataDir

Configure a custom directory:

ui5 config set ui5DataDir /my/custom/location/.ui5

Unset the configuration to switch back to the default directory:

ui5 config set ui5DataDir