Custom Application Logo

The default logo visible in the navigation bar of BlueMind applications can be customized and replaced by an image of your choice:

Shared environment / multi-domains

The logo refers to an installation, so the same logo will appear regardless of the domain.

Image prerequisites

The logo must be:

• Format: PNG
• Dimensions (w,h): 140x40 pixels
  ⚠️ If the dimensions are not respected, the image will be automatically resized to fit into the defined space. It is therefore recommended to pay special attention to the aspect ratio of the image.
• Background color: The background color of the banner is dark blue, so all transparent areas of the image will appear dark blue to users.

  💡 hexadecimal code: #0a2a86

Implementation

Adding a new logo

Enter the following command:

curl -X PUT --header 'X-BM-ApiKey: TOKEN_ADMIN0' -H "Content-Type: application/octet-stream" --data-binary "@/path/to/logo.png" 'https://mail.bluemind.loc/api/system/installation/logo'

Replacing:

• TOKEN_ADMIN0: the token of admin0 or one of its API keys, only he can modify the image.

  💡 The token is located in the file /etc/bm/bm-core.tok
   
  Note: If the token is incorrect, you will get a PERMISSION DENIED warning

• @/path/to/logo.png: the path to the image file. This can be a local path (the file is located on the server on which the operation is being performed) or a remote one.

  💡 Always keep the @ symbol in front of the path when using a local path.

• mail.bluemind.loc: the URL of the relevant BlueMind.

Reverting to the original BlueMind logo

To revert to the default BlueMind logo, simply delete the customized logo:

curl -X DELETE --header 'X-BM-ApiKey: TOKEN_ADMIN0' 'https://mail.bluemind.loc/api/system/installation/logo'

Replacing:

• TOKEN_ADMIN0: the token of admin0, only he can modify the image.

  Note: If the token is incorrect, you will get a PERMISSION DENIED warning

• mail.bluemind.loc: the URL of the relevant BlueMind.