How to Change the Favicon in Metabase (Self-Hosted Version)
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:
- SSH user with sudo privileged access
- 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.