# \#FAQs

**URL:** https://community.interop.io/tag/faqs/4.md

[Latest](https://community.interop.io/latest.md) · [Categories](https://community.interop.io/categories.md) · [Tags](https://community.interop.io/tags.md)

---

## [Understanding the separate processes running](https://community.interop.io/t/understanding-the-separate-processes-running/635)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [September 27, 2026, 9:00pm UTC](https://community.interop.io/t/understanding-the-separate-processes-running/635 "2026-09-27T21:00:00Z")

</div>

If you open Task Manager or profile memory while io.Connect Desktop is running, you will see a number of separate OS processes rather than a single one. Because io.Connect Desktop is built on Electron and Chromium, Task…

---

## [\[FAQ\] How to Track Download Success using startDrag API](https://community.interop.io/t/faq-how-to-track-download-success-using-startdrag-api/682)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [August 28, 2026, 5:22am UTC](https://community.interop.io/t/faq-how-to-track-download-success-using-startdrag-api/682 "2026-08-28T05:22:15Z")

</div>

Applies to: io.Connect Desktop 9.7.1 and later. Question When using io.windows.my().startDrag() to enable native file drag-and-drop from a web app, how can I tell whether the file download succeeded or failed in order t…

---

## [DPI scaling, display coordinates and window bounds](https://community.interop.io/t/dpi-scaling-display-coordinates-and-window-bounds/665)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [August 21, 2026, 1:22pm UTC](https://community.interop.io/t/dpi-scaling-display-coordinates-and-window-bounds/665 "2026-08-21T13:22:25Z")

</div>

If you position windows programmatically and your users run mixed-DPI or high-DPI monitors, windows can end up in the wrong place or wrong size, because of mixing two different coordinate systems. The three coordinate s…

---

## [Diagnosing High Desktop CPU Usage](https://community.interop.io/t/diagnosing-high-desktop-cpu-usage/663)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [August 20, 2026, 7:15pm UTC](https://community.interop.io/t/diagnosing-high-desktop-cpu-usage/663 "2026-08-20T19:15:54Z")

</div>

Below are some tips on how to track down the causes of high CPU usage and determine whether it’s caused by an app(s), platform misconfiguration, Chromium/Electron, or simply an under-resourced machine. How do I see per-…

---

## [\[FAQ\] Custom URL protocol links with target="\_blank" don't open in io.Connect Desktop](https://community.interop.io/t/faq-custom-url-protocol-links-with-target-blank-dont-open-in-io-connect-desktop/651)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [August 11, 2026, 9:19am UTC](https://community.interop.io/t/faq-custom-url-protocol-links-with-target-blank-dont-open-in-io-connect-desktop/651 "2026-08-11T09:19:50Z")

</div>

Problem A custom URL protocol is registered on the machine through a .reg file. Clicking anchor links that use the target="\_blank" attribute does nothing after upgrading to 9.9. Removing target="\_blank" from the anchor …

---

## [\[FAQ\] Migrating stickywindows.json to v10: properties mapping](https://community.interop.io/t/faq-migrating-stickywindows-json-to-v10-properties-mapping/645)

<div class="topic-metadata">

**Author:** [@bvalev](https://community.interop.io/u/bvalev)\
**Replies:** 0\
**Last updated:** [August 3, 2026, 8:51am UTC](https://community.interop.io/t/faq-migrating-stickywindows-json-to-v10-properties-mapping/645 "2026-08-03T08:51:31Z")

</div>

Checked against io.Connect Desktop 10.3.0 and its shipped configuration schema, with v9 behavior checked against 9.13.0. Defaults do move between releases, so confirm against the changelog for the version you’re upgradi…

---

## [Unresponsive Apps in io.Connect Desktop stack tracing](https://community.interop.io/t/unresponsive-apps-in-io-connect-desktop-stack-tracing/644)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 30, 2026, 10:32am UTC](https://community.interop.io/t/unresponsive-apps-in-io-connect-desktop-stack-tracing/644 "2026-07-30T10:32:33Z")

</div>

If a window in io.Connect Desktop stops updating or stops responding to input, the logs will usually contain an “unresponsive” message. io.Connect Desktop writes log lines in this form when an app stops responding, and a…

---

## [Executing JavaScript in the context of another io.Connect Window](https://community.interop.io/t/executing-javascript-in-the-context-of-another-io-connect-window/625)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 29, 2026, 9:46pm UTC](https://community.interop.io/t/executing-javascript-in-the-context-of-another-io-connect-window/625 "2026-07-29T21:46:51Z")

</div>

Question I want to execute a JavaScript function within the context of another window running in io.Connect Desktop, calling a function exposed by a third-party web application hosted in the platform. I know this can be…

---

## [\[FAQ\] Installer shortcuts not available to end user](https://community.interop.io/t/faq-installer-shortcuts-not-available-to-end-user/637)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 21, 2026, 1:48pm UTC](https://community.interop.io/t/faq-installer-shortcuts-not-available-to-end-user/637 "2026-07-21T13:48:03Z")

</div>

Applies to: io.Connect Desktop 9.4 and later Problem I repackaged the io.Connect Desktop installer to create , but after installation the desktop and/or Start Menu shortcuts don’t appear for the end user. Cause This ca…

---

## [io.Connect Legacy Metrics vs. io.Insights (OpenTelemetry) comparison](https://community.interop.io/t/io-connect-legacy-metrics-vs-io-insights-opentelemetry-comparison/624)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 20, 2026, 7:27am UTC](https://community.interop.io/t/io-connect-legacy-metrics-vs-io-insights-opentelemetry-comparison/624 "2026-07-20T07:27:30Z")

</div>

When setting up telemetry in io.Connect Desktop, you may come across two different configuration styles: A "metrics" configuration that lists publishers, a rest endpoint, and filters (whitelist/blacklist). An "otel…

---

## [How to filter and reduce the volume of Legacy metrics published by io.Connect Desktop](https://community.interop.io/t/how-to-filter-and-reduce-the-volume-of-legacy-metrics-published-by-io-connect-desktop/626)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 15, 2026, 7:07am UTC](https://community.interop.io/t/how-to-filter-and-reduce-the-volume-of-legacy-metrics-published-by-io-connect-desktop/626 "2026-07-15T07:07:19Z")

</div>

Applies to: legacy Metrics API Note: the legacy Metrics API is deprecated The legacy Metrics API described above is deprecated in favor of the OpenTelemetry-based io.Insights - see the Legacy io.Insights overview, whi…

---

## [\[FAQ\] Custom Environment Variables Not Accessible via iodesktop.env](https://community.interop.io/t/faq-custom-environment-variables-not-accessible-via-iodesktop-env/620)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 13, 2026, 3:34pm UTC](https://community.interop.io/t/faq-custom-environment-variables-not-accessible-via-iodesktop-env/620 "2026-07-13T15:34:23Z")

</div>

Problem I’ve set custom environment variables in the gilding.json configuration file (9.x) and the platform log confirms the configuration file is read successfully. However, when I try to access the custom variables pro…

---

## [\[FAQ\] Deploying io.Connect Desktop silently to machines when no user is logged in](https://community.interop.io/t/faq-deploying-io-connect-desktop-silently-to-machines-when-no-user-is-logged-in/619)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 9, 2026, 8:35am UTC](https://community.interop.io/t/faq-deploying-io-connect-desktop-silently-to-machines-when-no-user-is-logged-in/619 "2026-07-09T08:35:32Z")

</div>

Applies to: io.Connect Desktop 9.x (installer + extensibility.json model). See the note at the end for io.Connect Desktop 10.0+. Q: Why the installation only works when a user is actively logged in? When you push io.Co…

---

## [How to Set Default Window Size for a .NET App on First Opening](https://community.interop.io/t/how-to-set-default-window-size-for-a-net-app-on-first-opening/618)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 8, 2026, 11:39am UTC](https://community.interop.io/t/how-to-set-default-window-size-for-a-net-app-on-first-opening/618 "2026-07-08T11:39:41Z")

</div>

When registering .NET applications programmatically with io.Connect Desktop, you can control the initial window size on first launch, while still allowing users to resize the window freely afterward, with their custom si…

---

## [How to Schedule Nightly Restart or Shutdown of io.Connect Desktop](https://community.interop.io/t/how-to-schedule-nightly-restart-or-shutdown-of-io-connect-desktop/617)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 6, 2026, 7:38am UTC](https://community.interop.io/t/how-to-schedule-nightly-restart-or-shutdown-of-io-connect-desktop/617 "2026-07-06T07:38:19Z")

</div>

If you want to automatically restart or shut down io.Connect Desktop on a schedule, for example, a nightly restart to free up resources, here’s how: Built-In Scheduled Restart & Shutdown (io.Connect Desktop 9.4+) Since i…

---

## [\[FAQ\] How to Set Up Different Default Layouts Per Machine in io.Connect Desktop](https://community.interop.io/t/faq-how-to-set-up-different-default-layouts-per-machine-in-io-connect-desktop/615)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [July 1, 2026, 3:26pm UTC](https://community.interop.io/t/faq-how-to-set-up-different-default-layouts-per-machine-in-io-connect-desktop/615 "2026-07-01T15:26:44Z")

</div>

Problem Users who work from multiple machines (e.g., home and office) want different default layouts to load automatically on each machine. By default, the starred (default) layout is a user-level preference and when a u…

---

## [Troubleshooting @interopio/ng Initialization Issues in Angular 15+](https://community.interop.io/t/troubleshooting-interopio-ng-initialization-issues-in-angular-15/614)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [June 30, 2026, 10:28am UTC](https://community.interop.io/t/troubleshooting-interopio-ng-initialization-issues-in-angular-15/614 "2026-06-30T10:28:06Z")

</div>

Problem When initializing the @interopio/ng library using IOConnectNg.forRoot() directly in an @NgModule imports array e.g., in app.module.ts, intermittently get hard to pin down errors like: "Cannot initiate glue, bec…

---

## [Cannot initiate glue, because this window was not opened or created by a glue client io.Connect Browser Initialization Error](https://community.interop.io/t/cannot-initiate-glue-because-this-window-was-not-opened-or-created-by-a-glue-client-io-connect-browser-initialization-error/613)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [June 29, 2026, 10:57am UTC](https://community.interop.io/t/cannot-initiate-glue-because-this-window-was-not-opened-or-created-by-a-glue-client-io-connect-browser-initialization-error/613 "2026-06-29T10:57:27Z")

</div>

Problem When initializing @interopio/browser in a Browser Client application, you may encounter the following error if the app is opened directly in the browser rather than through an io.Connect Main app via this.store.g…

---

## [\[FAQ\] How to Add Custom Labels/Attributes to interop.io OpenTelemetry Metrics](https://community.interop.io/t/faq-how-to-add-custom-labels-attributes-to-interop-io-opentelemetry-metrics/598)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [June 8, 2026, 7:23pm UTC](https://community.interop.io/t/faq-how-to-add-custom-labels-attributes-to-interop-io-opentelemetry-metrics/598 "2026-06-08T19:23:51Z")

</div>

Question How to add custom labels or attributes to the OpenTelemetry metrics exported by interop.io, to differentiate metrics by environment, internal platform version, or any other dimension relevant to your organizatio…

---

## [How to Enable File Logging for an SSO Application in io.Connect Desktop 9.0](https://community.interop.io/t/how-to-enable-file-logging-for-an-sso-application-in-io-connect-desktop-9-0/594)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [June 5, 2026, 8:09am UTC](https://community.interop.io/t/how-to-enable-file-logging-for-an-sso-application-in-io-connect-desktop-9-0/594 "2026-06-05T08:09:57Z")

</div>

Applies to: io.Connect Desktop (9.x version stream) Problem When using an SSO application in io.Connect Desktop, logs from window.io.logger appear in the browser console but are not written to any log files (e.g., appli…

---

## [\[FAQ\] io.Connect 9.x Installation Location and Packaging](https://community.interop.io/t/faq-io-connect-9-x-installation-location-and-packaging/591)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [June 1, 2026, 7:49am UTC](https://community.interop.io/t/faq-io-connect-9-x-installation-location-and-packaging/591 "2026-06-01T07:49:06Z")

</div>

Note: This article applies only to the io.Connect Desktop 9.x version stream. The deployment and packaging model changed significantly in io.Connect Desktop 10.0 and beyond. The extensible installer was replaced by the …

---

## [\[FAQ\] Node.js v22.12.0 app cannot connect to io.Connect Desktop](https://community.interop.io/t/faq-node-js-v22-12-0-app-cannot-connect-to-io-connect-desktop/585)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 22, 2026, 7:17am UTC](https://community.interop.io/t/faq-node-js-v22-12-0-app-cannot-connect-to-io-connect-desktop/585 "2026-05-22T07:17:08Z")

</div>

Problem A NodeJS application that uses @interopio/desktop does not connect to io.Connect Desktop when the application is started with Node.js v22.12.0. Root cause This was caused by a bug in Node.js v22.12.0. There is a…

---

## [\[FAQ\] How to Determine When an App Is Visible in Workspaces](https://community.interop.io/t/faq-how-to-determine-when-an-app-is-visible-in-workspaces/584)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 21, 2026, 7:25am UTC](https://community.interop.io/t/faq-how-to-determine-when-an-app-is-visible-in-workspaces/584 "2026-05-21T07:25:53Z")

</div>

Question The standard window visibility events used to track regular app windows (for example, to deactivate apps when they are minimized or running as a background tab) do not give a complete picture for apps that run i…

---

## [\[FAQ\] Caching of assets with different url parameters](https://community.interop.io/t/faq-caching-of-assets-with-different-url-parameters/582)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 19, 2026, 7:50am UTC](https://community.interop.io/t/faq-caching-of-assets-with-different-url-parameters/582 "2026-05-19T07:50:29Z")

</div>

Question Why static assets appear to be re-fetched when I open the same app via the API with different URL query parameters? Answer Caching treats each unique URL, including its query parameters, as a separate cache ent…

---

## [Cleaning up default build files with replace and delete markers](https://community.interop.io/t/cleaning-up-default-build-files-with-replace-and-delete-markers/580)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 14, 2026, 7:42am UTC](https://community.interop.io/t/cleaning-up-default-build-files-with-replace-and-delete-markers/580 "2026-05-14T07:42:10Z")

</div>

Overview When you customize io.Connect Desktop through the seed project, the contents of modifications/base/iocd/assets/ are merged with the platform component’s default assets. Files you don’t supply remain in the build…

---

## [Component Config Files in modifications/base/ Get Overwritten during Seed Project build](https://community.interop.io/t/component-config-files-in-modifications-base-get-overwritten-during-seed-project-build/578)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 13, 2026, 6:59am UTC](https://community.interop.io/t/component-config-files-in-modifications-base-get-overwritten-during-seed-project-build/578 "2026-05-13T06:59:19Z")

</div>

Problem When you place a custom app definition for some components in modifications/base/iocd/config/apps/, for example: modifications/base/iocd/config/apps/bbg-mdf.json Every time you run iocd build (or npm run build)…

---

## [Listing Emails from an Outlook Folder by Date with the io.Connect Outlook Adapter](https://community.interop.io/t/listing-emails-from-an-outlook-folder-by-date-with-the-io-connect-outlook-adapter/575)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [May 5, 2026, 9:26am UTC](https://community.interop.io/t/listing-emails-from-an-outlook-folder-by-date-with-the-io-connect-outlook-adapter/575 "2026-05-05T09:26:27Z")

</div>

The io.Connect Outlook Adapter exposes an interop method, T42.Outlook.AdvancedSearch. A common use case is listing all emails received in a monitored folder for a given period, for example, when an app starts or restarts…

---

## [\[FAQ\] How to Open a URL in the Default Browser in io.Connect Desktop](https://community.interop.io/t/faq-how-to-open-a-url-in-the-default-browser-in-io-connect-desktop/566)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [April 27, 2026, 9:09am UTC](https://community.interop.io/t/faq-how-to-open-a-url-in-the-default-browser-in-io-connect-desktop/566 "2026-04-27T09:09:24Z")

</div>

Question How to set an app to be opened in the default browser from Launchpad/toolbar instead of in an io.Connect Desktop Window Answer An easy solution is to create an app that remains hidden and opens the required URL…

---

## [\[FAQ\] Forwarding Logs from a Specific Application to Logstash in io.Connect Desktop](https://community.interop.io/t/faq-forwarding-logs-from-a-specific-application-to-logstash-in-io-connect-desktop/565)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [April 24, 2026, 7:06am UTC](https://community.interop.io/t/faq-forwarding-logs-from-a-specific-application-to-logstash-in-io-connect-desktop/565 "2026-04-24T07:06:19Z")

</div>

Question How do I forward logs from only one specific application to Logstash or another log collector, without forwarding logs from all applications? Log4js does not support filtering individual files within a multiFil…

---

## [\[FAQ\] OTEL unreachable and fallback](https://community.interop.io/t/faq-otel-unreachable-and-fallback/562)

<div class="topic-metadata">

**Author:** [@toni.petrov](https://community.interop.io/u/toni.petrov)\
**Replies:** 0\
**Last updated:** [April 21, 2026, 8:31am UTC](https://community.interop.io/t/faq-otel-unreachable-and-fallback/562 "2026-04-21T08:31:06Z")

</div>

Question When using io.Insights how does io.Connect handle unreachable OTEL collectors? Answer When the endpoint configured in otel.metrics.url cannot accept metric exports, io.Connect relies on the underlying OTLP expo…

[Next page](https://community.interop.io/tag/faqs/4.md?match_all_tags=true&page=1&tags%5B%5D=FAQs)
