Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
You can customize the CycleCloud theme to better match your organization's look and feel. To create a theme, you need some knowledge of Cascading Style Sheets (CSS).
Creating a theme
To create your own theme, go to the config/web directory of your installation and edit the theme.css file. This file contains CSS variables that you can change to customize colors, images, and other CSS properties.
Although you can use this file to override other CSS rules, we don't recommend it. Only the variables listed in theme.css are supported across different versions.
You can also use the config/web directory to serve content like images, which you can reference in your CSS. All files you put in this directory are served under the URL static/config/web.
For example, to change the logo to a custom image named my-logo-icon.png, first copy the image into config/web, and then add the following to theme.css:
:root {
--theme-header-logo-url: url("static/config/web/my-logo-icon.png");
}
Enabling a theme
By default, theming is disabled. To enable your theme, sign in to the user interface as a super user and go to the Settings page. Open the Theme settings and toggle the Custom Theme checkbox to enable or disable your theme. Refresh your web browser to view the changes.
You can also enable or disable theming from the command line. Run the following commands in your installation directory.
To enable a theme:
./cycle_server theme enable
To disable a theme:
./cycle_server theme disable
Modifying the brand
To change the brand (Azure CycleCloud) that appears in the header, sign in to the user interface as a super user and go to the Settings page. Open the Theme settings and modify the brand text. You must refresh your web browser to view the new brand.