Customize the Hue Web UI

The Hue Web UI has the following customization options in hue.ini under [desktop] > [[custom]].

Hue requires that the machines in your cluster connect to each other freely over TCP. Machines not in the cluster must be able to open TCP port 8888 on the Hue Server (or the configured Hue web HTTP port) to interact with the system.

Supported Browsers

Hue works with the two most recent LTS (long term support) or ESR (extended support release) browsers. Cookies and JavaScript must be on. Hue can display in older, and other, browsers, but you might not have access to all of its features.

Banner

You can add a custom banner to the Hue Web UI by applying HTML directly to the property, banner_top_html. For example:
banner_top_html=<H4>My company's custom Hue Web UI banner</H4>
To configure a banner in Cloudera Manager:
  1. Go to the Hue service.
  2. Click the Configuration tab.
  3. Select Scope > Hue Server and Category > Advanced.
  4. Locate Top Banner Custom HTML and input your desired HTML in the text field.
  5. Click Save Changes to commit the changes.
  6. Select Actions > Restart and, when done, click Close.
  7. Click Web UI to view your changes.

Splash Screen

You can customize a splash screen on the login page by applying HTML directly to the property, login_splash_html. For example:
login_splash_html=WARNING: You are required to have authorization before you proceed.
To configure a splash screen in Cloudera Manager:
  1. Go to the Hue > Configuration.
  2. Search for Hue Service Advanced Configuration Snippet (Safety Valve) for hue_safety_valve.ini.
  3. Add your HTML in the text field:
    [desktop]
    [[custom]]
    login_splash_html=WARNING: You are required to have authorization before you proceed.
  4. Click Save Changes to commit the changes.
  5. Select Actions > Restart and, when done, click Close.
  6. Click Web UI to view your changes.

Cache Timeout

Enable Hue UI caching by setting a timeout in milliseconds. The default is 86400000 milliseconds or one day. Set the timeout to 0 to disable caching.

You can set the cache timeout under [desktop][[custom]] in Hue Service Advanced Configuration Snippet (Safety Valve) for hue_safety_valve.ini.
[dekstop]
[[custom]]
cacheable_ttl=86400000

Anonymous Usage Data Collection

Hue tracks anonymized pages and application versions to gather information about application usage levels. The data collected does not include hostnames or IDs.

You can restrict data collection under [desktop] in Hue Service Advanced Configuration Snippet (Safety Valve) for hue_safety_valve.ini.

[desktop]
...
# Help improve Hue with anonymous usage analytics. 
# Use Google Analytics to see how many times an application or specific section of an application is used, nothing more.  
## collect_usage=false