Introduction:

Metabase is a great tool for creating dashboards and sharing data. But if you host it yourself, you might want to change the default icon (called a favicon) to match your brand or company. This small change can make Metabase feel more professional and personalised.

Prerequisites:

  1. SSH user with sudo privileged access
  2. Favicon in the format .ico

Implementation:

Step 1: Stop Metabase

$ sudo systemctl stop metabase

Step 2 : Create a working directory

$ mkdir ~/metabase-custom && cd ~/metabase-custom

Step 3: Back up the original JAR file

$ mkdir -p /opt/backup-jar
$ sudo cp /opt/metabase/metabase.jar /opt/backup-jar/metabase-$(date +%F).jar

Step 4: Unpack the JAR

$ cp /opt/metabase/metabase.jar ./metabase-original.jar
$ unzip metabase-original.jar -d metabase-unpacked

Step 5: Find and replace every favicon.ico

Metabase keeps several copies of the icon for legacy build targets. Replace them all

$ find metabase-unpacked -name favicon.ico

$ cp <path to the new favicon.ico> metabase-unpacked/resources/frontend_client/app/assets/img/favicon.ico

Step 6: Re‑package the JAR

$ cd metabase-unpacked
$ zip -r ../metabase-custom.jar *
$ cd ..

Step 7 : Deploy the new JAR

$ sudo mv metabase-custom.jar /opt/metabase/metabase.jar
$ sudo chown metabase:metabase /opt/metabase/metabase.jar

Step 8: Restart and verify

$ sudo systemctl restart metabase
$ sudo systemctl status metabase

Conclusion:

Changing the favicon in Metabase is a simple way to give your dashboard a custom look.

Leave a Reply