Skip to content

Upload Custom Logo on Traceable Platform

This guide explains how to upload a custom logo to the Traceable Platform.

Overview

You can customize the Traceable Platform with your organization's logo using one of two methods:

  • Option 1: Host the logo on your own server and provide the URL
  • Option 2: Upload the logo directly to the platform

Prerequisites

  • Access to the Traceable Operator (TI) UI
  • Custom logo image file (JPEG, PNG, etc.)
  • Logo dimensions: 260 pixels wide × 110 pixels tall (maximum)

Option 1: External Logo Hosting

Use this method if your logo is hosted on an external server accessible from the platform.

Step 1: Navigate to Keycloak Helm Chart

  1. Login to the Traceable Operator (TI)
  2. Click on Helm Releases
  3. Filter by Keycloak
  4. Click on the Keycloak release name

Step 2: Update Helm Values

Edit user/values.yaml and add:

customLogo:
  enabled: true
  customerFqdnUrl: '<URL-for-your-logo>'

Example:

customLogo:
  enabled: true
  customerFqdnUrl: 'https://cdn.yourcompany.com/logos/company-logo.png'

Step 3: Save Configuration

Click Save All to save the changes.

Step 4: Upgrade Helm Release

  1. Click Helm Upgrade
  2. Click Helm Upgrade again to confirm

Step 5: Verify

Refresh the platform UI and verify the custom logo is displayed correctly.

Use this method to upload the logo directly to the platform.

Step 1: Navigate to Keycloak Helm Chart

  1. Login to the Traceable Operator (TI)
  2. Click on Helm Releases
  3. Filter by Keycloak
  4. Click on the Keycloak release name

Edit user/values.yaml and add:

customLogo:
  enabled: true

Step 3: Save Configuration

Click Save All to save the changes.

Step 4: Upgrade Helm Release

  1. Click Helm Upgrade
  2. Click Helm Upgrade again to confirm
  1. Navigate to Tasks → UploadCustomLogo
  2. Click Save and Next
  3. Upload Image: Select the custom logo file from your local system
  4. Click Save and Next (Review)
  5. Click Start Install

Step 6: Verify

Refresh the platform UI and verify the custom logo is displayed correctly.

Logo Requirements

Requirement Specification
Maximum Width 260 pixels
Maximum Height 110 pixels
Supported Formats JPEG, PNG, GIF, SVG
Background Transparent recommended

Tips:

  • Use a logo with transparent background for best results
  • Test the logo on both light and dark backgrounds
  • Ensure the logo is legible at the specified dimensions

Troubleshooting

Logo Not Displaying

Symptoms: Logo doesn't appear after configuration.

Solutions:

  1. Clear browser cache and refresh
  2. Verify the Helm upgrade completed successfully
  3. Check Keycloak pod logs for errors:
kubectl logs -n traceable -l app=keycloak
  1. Verify the logo URL is accessible (for external hosting)

Logo Appears Distorted

Symptoms: Logo is stretched or cropped incorrectly.

Solutions:

  1. Resize logo to fit within 260×110 pixels
  2. Maintain aspect ratio when resizing
  3. Use PNG format for logos with transparency

External Logo URL Not Working

Symptoms: Logo from external URL doesn't load.

Solutions:

  1. Verify the URL is accessible from the platform
  2. Check for CORS restrictions
  3. Ensure HTTPS is used if the platform uses HTTPS
  4. Verify firewall rules allow outbound access to the logo URL

To revert to the default Traceable logo:

  1. Navigate to Keycloak Helm chart
  2. Update user/values.yaml:
customLogo:
  enabled: false
  1. Save and upgrade the Helm release

Support

For logo customization assistance, contact: support@harness.io