You may want to change some default settings of the ITA web client, for example, if you want to brand your site with your own logo or color.
These settings are available in the branding folder on your ITA server and can be changed through the server management interface (Webmin).
Replacing login background image, icon, company name and logo
Replacing the icon will change the icon you see on login as well as the small icon in the top left corner of the web client.
Regardless of your image size, it will be automatically scaled to fit into the position of the default image. However, it's recommended to use a photo in a square shape for the logo.png file.
- Rename your custom file(s)
- background image --> bg_login.jpg.
- logo --> logo.png
- company logo --> company_logo.png
- Open the server management web interface (Webmin); type the address of your ITA server in a web browser followed by :10000,
https://<server IP address>:10000
. - Log on to Webmin using the user credentials created during the server installation.
- In the left menu, select System > Upload and Download.
- On the Upload to server tab:
- Click Choose Files in Files to upload and navigate to your saved bg_login.jpg file. Same procedure for logo.png file and company_logo.png file.
- In File or directory to upload to navigate to the branding folder on your server:
/var/www/web/resources/branding
. - In Owned by user and Owned by group, select dcojboss.
- Click Upload.
- Close and reopen your web browser and type the server address to access the login screen with your new custom images.
Changing website color theme
The color theme determines the color of borders in the web client (default green), e.g. borders of dialog boxes, borders in license icons, borders in room icons in the inventory, etc.
- Open and log in to Webmin as described above and navigate to System > Upload and Download in the left menu.
-
On the Download from server tab, navigate to the branding folder on your server:
/var/www/web/resources/branding
. Download the branding.css file. - Open the branding.css file, make your changes to the color codes, and save the file.
Tip: You can find an introduction to HEX color codes here: http://www.w3schools.com/cssref/css_colors.asp. - Reopen the Webmin interface and navigate to System>Upload and Download.
- On the Upload to server tab:
- Click Choose Files in Files to upload and navigate to your saved branding.css file.
- In File or directory to upload to navigate to the branding folder on your server:
/var/www/web/resources/branding
. - In Owned by user and Owned by group, select dcojboss.
- Click Upload.
- Close and reopen your web browser and type the server address to log in to the web client with your custom color theme.
Changing help link
The default help link goes to our support and help site. To redirect to your custom help site, change the settings in the branding.json file.
- Open and log in to Webmin as described above and navigate to System > Upload and Download in the left menu.
- On the Download from server tab, navigate to the branding folder on your server:
/var/www/web/resources/branding
. Download the branding.json file. - Open the branding.json file, make your changes to the link, and save the file.
{
"subTitle": "",
"title": "IT Advisor",
"helpUrl": "https://helpcenter.ecostruxureit.com",
"tenantPortalUrl": ""
} - Reopen the Webmin interface and navigate to System > Upload and Download.
- On the Upload to server tab:
- Click Choose Files in Files to upload and navigate to your saved branding.json file.
- In File or directory to upload to navigate to the branding folder on your server:
/var/www/web/resources/branding
. - In Owned by user and Owned by group, select dcojboss.
- Click Upload.
- Close and reopen your web browser and type the server address to log in to the web client with your custom help link.
Configuring Tenant Portal link
To redirect your tenants to access the Tenant Portal from an external URL, change the setting in the branding.json file. The URL you specify here will be shown in the onboarding email sent to your tenants, welcoming them and instructing them how to access the Tenant Portal.
Note: The DMZ setup protecting ITA against direct Internet access is entirely your own responsibility! See recommended setup in the Web proxy server setup guide.
- Open and log in to Webmin as described above and navigate to System > Upload and Download in the left menu.
- On the Download from server tab, navigate to the branding folder on your server:
/var/www/web/resources/branding
. Download the branding.json file. - Open the branding.json file, make your changes to the link, and save the file.
{
"subTitle": "",
"title": "IT Advisor",
"helpUrl": "http://helpcenter.ecostruxureit.com",
"tenantPortalUrl": ""
} - Reopen the Webmin interface and navigate to System > Upload and Download.
- On the Upload to server tab:
- Click Choose Files in Files to upload and navigate to your saved branding.json file.
- In File or directory to upload to navigate to the branding folder on your server:
/var/www/web/resources/branding
. - In Owned by user and Owned by group, select dcojboss.
- Click Upload.
- Close and reopen your web browser and type your new URL to log in to the Tenant Portal.