User Interface

Troubleshooting UI customization issues.

Logo Not Displaying

Symptom: Custom logo doesn’t appear in web interface.

Solutions:

1. Check file exists:

   ls -la /var/knot/public/logo.svg

2. Verify permissions:

   chmod 644 /var/knot/public/logo.svg

3. Check configuration: Ensure public_files_path and logo_url are correct in knot.toml

4. Clear browser cache: Force refresh (Ctrl+F5 or Cmd+Shift+R)

5. Check server logs: Look for file serving errors

Logo Looks Wrong in Dark Theme

Symptom: Logo is invisible or hard to see in dark theme.

Solutions:

1. Enable logo inversion:

   [server.ui]
   logo_invert = true

2. Provide separate dark theme logo:

   [server.ui]
   logo_url = "/public-files/logo-light.svg"
   logo_dark_url = "/public-files/logo-dark.svg"

Gravatar Not Loading

Symptom: User profile images don’t appear.

Solutions:

• Check enable_gravatar = true in configuration
• Verify internet connectivity from server
• Check firewall allows connections to gravatar.com
• Ensure users have valid email addresses
• Verify users have Gravatar accounts