Problem: IMAP/SMTP configuration is not displayed under "Connect your device" in OX App Suite

[fdavid]

Problem

After opening Settings → Connect your device in the Open-Xchange App Suite, the Server settings section is empty. As a result, users do not see the IMAP and SMTP server information required to manually configure their mail clients.

Root Cause

The server settings displayed in the Connect your device dialog are not configured in the App Suite frontend itself. They are provided by the OX Client Onboarding framework.

Two prerequisites must be met:

1. The IMAP/SMTP server information must be configured in client-onboarding-mail.properties.
2. The onboarding scenarios mailmanual and mailsync must be enabled in client-onboarding-scenarios.yml.

On UCS systems, the IMAP/SMTP properties can be managed using UCR. However, the onboarding scenarios are disabled by default and must be enabled manually.

Solution

Configure the IMAP and SMTP server settings using UCR.

Example:

MAILHOST="mail.example.org"

ucr set \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.imap.host="$MAILHOST" \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.imap.port="993" \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.imap.secure="true" \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.smtp.host="$MAILHOST" \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.smtp.port="587" \
  ox/cfg/client-onboarding-mail.properties/com.openexchange.client.onboarding.mail.smtp.secure="true"

Next, enable the required onboarding scenarios.

Create a backup of the configuration file:

cp -a /opt/open-xchange/etc/client-onboarding-scenarios.yml \
  /opt/open-xchange/etc/client-onboarding-scenarios.yml.bak.$(date +%Y%m%d-%H%M%S)

Enable the mailsync and mailmanual scenarios:

sed -i -E '/^mailsync:/,/^[^[:space:]]/{s/^([[:space:]]*)enabled:[[:space:]]*false/\1enabled: true/}' \
  /opt/open-xchange/etc/client-onboarding-scenarios.yml

sed -i -E '/^mailmanual:/,/^[^[:space:]]/{s/^([[:space:]]*)enabled:[[:space:]]*false/\1enabled: true/}' \
  /opt/open-xchange/etc/client-onboarding-scenarios.yml

Reload the Open-Xchange configuration:

/opt/open-xchange/sbin/reloadconfiguration

Finally, log out of Open-Xchange, log in again, and reopen Settings → Connect your device. The server settings should now be displayed correctly.

Note

The settings stored via UCR are persistent and managed by UCS. In contrast, the manual modification of /opt/open-xchange/etc/client-onboarding-scenarios.yml is not managed by UCR. While the change survives service restarts and should normally survive package updates because the file is treated as a Debian configuration file, it should be verified after Open-Xchange app updates, package reinstalls, or major UCS/Open-Xchange upgrades.