4.1. Introduction#

4.1.1. Access#

The UCS web interface can be opened on any UCS system via the URL https://servername/. Alternatively, access is also possible via the server’s IP address. Under certain circumstances it may be necessary to access the services over an insecure connection (e.g., if no SSL certificates have been created for the system yet). In this case, http must be used instead of https in the URL. In this case, passwords are sent over the network in plain text!

4.1.2. Browser compatibility#

The UCS web interface uses numerous JavaScript and CSS functions. Cookies need to be permitted in the browser. The following browsers are supported:

  • Chrome as of version 85

  • Firefox as of version 78

  • Microsoft Edge as of version 88

  • Safari and Safari Mobile as of version 13

Users with older browsers may experience display problems or the site does not work at all.

The UCS web interface is available in German and English (and French if it is chosen as language during the installation from DVD); the language to be used can be changed via the entry Switch language of the user menu in the upper right corner.

4.1.3. Switching between dark and light theme for UCS web interfaces#

All UCS web interfaces have a dark and a light theme that can be switched between with the Univention Configuration Registry Variable ucs/web/theme. The value of ucs/web/theme corresponds to a CSS file under /usr/share/univention-web/themes/ with the same name (without file extension). For example, setting ucs/web/theme to light will use /usr/share/univention-web/themes/light.css as theme for all UCS web interfaces.

4.1.4. Creating a custom theme/Adjusting the design of UCS web interfaces#

To create a custom theme it is advised not to edit /usr/share/univention-web/themes/dark.css or /usr/share/univention-web/themes/light.css since the changes may be overwritten when upgrading UCS. Instead copy one of these files to e.g. /usr/share/univention-web/themes/mytheme.css and set the Univention Configuration Registry Variable ucs/web/theme to mytheme.

The files /usr/share/univention-web/themes/dark.css and /usr/share/univention-web/themes/light.css contain the same list of CSS variables. These variables are used in other CSS files and are the supported layer of configurability for UCS web interfaces. The names and current use case for these variables will not change between UCS upgrades but new ones may be added.

Some UCS web interfaces import their own local custom.css file which can be used to further adjust the design of that page. These are /usr/share/univention-management-console-login/css/custom.css (Login via single sign-on) and /usr/share/univention-portal/custom.css (UCS portal page). The files are empty when installing UCS and are not modified when installing any UCS update. Be aware though that a given CSS selector may break when installing any UCS update.

4.1.5. Feedback on UCS#

By choosing the Help ‣ Feedback option in the upper right menu, you can provide feedback on UCS via a web form.

4.1.6. Collection of usage statistics#

Anonymous usage statistics on the use of the UCS web interface are collected when using the core edition version of UCS (which is generally used for evaluating UCS). Further information can be found in KB 6701 - Data collection in Univention Corporate Server.