How to Install Zimbra Universal UI

Posted by

This Zimbra Universal UI was obtained from Unofficial Zimbra 8.8.5 that created by Zeta Alliance. I am copying zimbra folder from webapps and save into my Github. This Zimbra Universal UI have been tested by me on Zimbra 8.8.12/8.8.15 and working properly. If you want to try installing this Zimbra Universal UI on your Zimbra, please try the guide below

# Backup Zimbra folder from webapps

cd /opt/zimbra/jetty/webapps/
tar -czvf /srv/zimbra-webapps.tgz zimbra

The backup file will save in the /srv/ folder

# Download Zimbra Universal UI

cd /tmp/
wget -c

# Extract and Rsync

tar -zxvf zimbra-ui.tgz
rsync -avP /tmp/zimbra/ /opt/zimbra/jetty/webapps/zimbra/

# Remove harmony themes and replace with Universal UI themes

Zimbra using harmony as default themes for webmail

cd /opt/zimbra/jetty/webapps/zimbra/skins/
rm -rvf harmony/
ln -sf clarity harmony

If there are other users who use special themes, you can delete and replace them with Universal UI themes

# Fixperms and Restart Zimbra Mailbox

/opt/zimbra/libexec/zmfixperms -v
su - zimbra -c "zmmailboxdctl restart"

Please try access Zimbra webmail from browser. The login screen should be the Zimbra Universal UI.

Below are some of the screenshot from Zimbra Universal UI

Good Luck 🙂

Source :


  1. What are the futures available in this Zimbra UI compare with harmony themes? Also, is it suitable for 8.7.7 version,?

    1. Cocok saja gan. Jika hendak dikembalikan, bisa ganti lagi isinya dari data webapps yang sudah di backup

      cd /opt/zimbra/jetty/webapps/
      mv zimbra zimbra-ui-skins
      cp /srv/zimbra-webapps.tgz .
      tar -xvf zimbra-webapps.tgz
  2. HI
    I followed the instructions but then received 500 errors.
    Release 8.8.15_GA_3829.RHEL7_64_20190718141144 RHEL7_64 FOSS edition, Patch 8.8.15_P1.
    Internal Server Error

    The server has encountered an internal error.
    Please try again later.
    ERROR: 500
    « Go back

      1. It worked
        I have an error in the signature
        One of the tests I’ve done is to enable the html signature and insert an embedded image in it (it is in the briefcase).
        Now, when I send an email, Zimbra webmail interface shows always the email with attachments (i.e. the image that I attached to my signature).

  3. I tried it on zimbra 8.8.15 OSE.
    It worked well.Thank you.
    But CSS is not work well, for example mail tab, I selected “inbox” or “Sent” or “Draft” “Junk” “Trash”
    it was not highlighted.
    I cannot know whether it is selected or not.
    The same things always occur in “Contacts” “Calendar” “Tasks” “Briefcase” and so on…
    If it works well, a slight grey which indicates just the place you choice.

    But you environment, as pict above, you seem to work almost perfectly.

    Would you tell me how to work well?


    1. Hey, this happens to me too!
      I already rsync again, fixperms, and restarts, as iman pointed, but css stills seems to be failing.
      Did you found a solution? Thanks in advance

        1. This is what happens:

          as you can see, im in the “Correo” (Mail) tab, but the color are all the same, so it can be confusing.
          Same happens if i open a Search or Preferences Tab:

          Playing around with the Chrome/Firefox inspector, im able to edit the css in real time and change de “.ZSelected .ZAppTabBorder” css item properties, allowing me to modify the color.
          By default, it shows as {background-color:;}. That means, empty!
          If i complete with some color there, it works.
          The problem is i dont know why that is empty in the first place.
          Here is a image of that too, in case you didnt follow me:

          Manual modified:

          Hope that can help you.

  4. Hi,I tried them.But css does not work properly.

    I am going to make 8.8.5’s environment of univ ui,and its raw /opt/zimbra/jetty/

    and,I will make 8.8.15’s environment.I would like to replace that directory.


  5. I will wait your video,thx.
    I appreciate to you.

    Which is the best way to install zextras suite or not?
    after your guide and modifying my sever, should I install zextras suite?
    or before modifying, should I install zextras suite?

  6. Hi Ahmad, do you recommend to use this skin in production environment? Is this skin vulnerable to Zimbra’s recent XSS security issues?

    1. Hello Tamas,
      I am not recommend this skin in production. Because this skin i get from ZCS 8.8.5. Maybe XSS security issues still exist

  7. Hi, Mr.Imanudin!

    Thank you for lots of precious informations!

    But now, I confront CSS problem too like other people.
    .ZSelected .ZAppTabBorder background color issue…just it is.

    If possible, would you mind uploading your directory(/opt/zimbra/jetty/webapps/zimbra) which works CSS perfectly?

    I am worried which files should I modify. I want to your dir and if you allow, let me copy,please.


      1. I want your perfectly working directory, not 8.8.5’s directory.

        So it is not Rsync, it just completely copy.
        rsync is Diff copy.perhaps including bad file or description.

        I will do below.(Am I Fastidious disease? I wonder)
        #rm -rf /opt/zimbra/jetty/webapps/zimbra/*
        #cp -r (your perfect working -now- 8.8.15’s /opt/zimbra/jetty/webapps/zimbra dire) to (my /opt/zimbra/jetty/webbapps/zimbra and fixparams

        My environment is ZCS8.8.15OSE (Patched up to date by yum) on CentOS7.7

        Thanks and I am waiting.Would you mind giving me your 8.8.15’dir?


  8. Hi, Imanudin!How are you? I hope you happy.

    By the way, have you already upload webapps on you Github?

    I am waiting…please


  9. Hi, the tutorial worked correctly, but when I try to update the libraries with yum update or yum upgrade, the following error appears:

    Transaction check error:
    file /opt/zimbra/jetty_base/webapps/zimbra/skins/beach/img/images.css conflicts between attempted installs of zimbra-mbox-webclient-war- and zimbra-mbox-webclient-war-
    file /opt/zimbra/jetty_base/webapps/zimbra/skins/beach/manifest.xml conflicts between attempted installs of zimbra-mbox-webclient-war- and zimbra-mbox-webclient-war-
    file /opt/zimbra/jetty_base/webapps/zimbra/skins/beach/ conflicts between attempted installs of zimbra-mbox-webclient-war- and zimbra-mbox-webclient-war-
    file /opt/zimbra/jetty_base/webapps/zimbra/skins/bones/img/images.css conflicts between attempted installs of zimbra-mbox-webclient-war- and zimbra-mbox-webclient-war-

    I appreciate if you have any solution for this

  10. How to restore from backup?
    Installed on 8.8.15, webmail login UI screen works fine, but does not load mail UI. any ideas?

    1. Hello Temo,
      If you follow all step on this article, you can restore with these commands

      cd /opt/zimbra/jetty/webapps/
      mv zimbra zimbra-ui-skins
      cp /srv/zimbra-webapps.tgz .
      tar -xvf zimbra-webapps.tgz
  11. Hi Iman,
    first of all thanks for your great efforts. I’ve followed your instructions on my Zimbra GA 8.8.12 installation. The logon prompt shows, but it gets stuck at loading the webapp. Seems like the previous commet. I could revert to the original webapp without any problems, but I would really fancy using the universal ui. Any ideas? Could not find anything in the logs that would help me…
    Thanks for your help!

      1. Hi Iman!
        Thanks for your quick reply. Unfortunately, that didn’t do the trick. Still getting stuck after the logon page. I’ll maybe try upgrading to 8.8.15 and see if it works that way. Or do you have any other ideas?
        Kind regards,

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.