Begin main content

Umbrello on Mac OS X

Update: You can now download and install a (currently beta) MacOS native KDE4 environment (including Umbrello) from the Mac KDE team. See my newer blog post for more info.

Umbrello is a great open source UML modelling tool. Unlike Argo UML it supports (a subset of) UML 2.0.

Being native code based on the KDE libraries it's much faster than Java tools (like Argo UML), but that also makes it less portable. I've never seen a workable installation of Umbrello on Windows. There are some partial attempts using KDE 4, and apparently it's possible with Cygwin.

It's pretty easy to install on Mac OS X, as long as you don't mind a bit of commandline work.

First you need Apple's developer tools and Then you need an installation of MacPorts which will do most of the hard work for you. There's no port for Umbrello, but it will install the myriad required libraries. Simply run:

sudo port install qt3 kdelibs3

and let it do the hard work.The whole process could take a few hours depending on your Mac model.

(I actually had to provide a bit of manual intervention, fetching hicolor-icon-theme-0.10.tar.gz from since the main site ( was down. I'm sure that will be fixed by the time you read this.)

Now to install Umbrello itself. Download the latest version from and follow the "Source Code" instructions on You will need to specify the qt and jpeg directories and turn off aRts support. If that makes no sense to you, the instructions boil down to:

tar jxf umbrello-1.5.7beta1.tar.bz2

cd umbrello-1.5.7beta1

./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts


sudo make install

Now you have a working Umbrello! Simply start and run /opt/local/bin/umbrello (you might want to add it to the "Applications" menu of via the "Customize Menu..." option).

It shouldn't be too long before we can have a native Trolltech has released a MacOS native Qt and it's certainly something that the KDE people are looking at.

Update: Umbrello 1.5.7 is now released - update your download accordingly.

Leopard Update: A kind anonymous poster gives this ./configure line for building in Leopard, but I haven't tried it yet:

For anyone having problems compiling umbrello in Leopard, use use this ./configure combo:

env LDFLAGS=-Wl,-dylib_file,/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib ./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts

08:19 AM, 14 May 2007 by Mark Aufflick Permalink

Ups!!!....Umbrello is working on my MacBookPro

I just wanted to drop a line to say thank you for the info provided for bringing umbrello up and running on my MBP. I was looking a clean way to do this for some time, but nothing was found until now. Thanks Again! Pablo Chile, South America :)

by Unregistered Visitor on 05/23/07

Thanks for the comment

I save so much time from tips other people have taken the time to post - I'm really glad that things I have figured out can help others too!

by Mark Aufflick on 05/24/07

problem with umbrello build

I have installed kdelibs3 and qt3 with umbrello, but when I try to build umbrello, it fails to configure with the next error: checking for KDE... libraries /opt/local/lib, headers /opt/local/include checking if UIC has KDE plugins available... no configure: error: you need to install kdelibs first. If you did install kdelibs, then the Qt version that is picked up by this configure is not the same version you used to compile kdelibs. The Qt Plugin installed by kdelibs is *ONLY* loadable if it is the _same Qt version_, compiled with the _same compiler_ and the same Qt configuration settings. I have verified that the dirs provided to configure are there: /opt/local/include/qt3 /opt/local/lib/qt3/ Do you have any idea of what's going on? H.G.

by Unregistered Visitor on 06/04/07

configure: error: you need to install kdelibs first.

I have followed the instructions as above, and I am seeing the same error as the above post. Error: configure: error: you need to install kdelibs first. If you did install kdelibs, then the Qt version that is picked up by this configure is not the same version you used to compile kdelibs. The Qt Plugin installed by kdelibs is *ONLY* loadable if it is the _same Qt version_, compiled with the _same compiler_ and the same Qt configuration settings. Here are my installed Ports aspell @0.60.5_0 (active) atk @1.11.4_0 (active) autoconf @2.61_1 (active) bzip2 @1.0.4_1 (active) cairo @1.0.4_0 (active) coreutils @6.9_0 (active) expat @2.0.0_1 (active) flex @2.5.33_0 (active) fontconfig @2.3.2_2+macosx (active) freetype @2.1.10_1 (active) gettext @0.14.6_0 (active) glib2 @2.10.3_0 (active) help2man @1.36.4_0+darwin_8 (active) hicolor-icon-theme @0.10_0 (active) jasper @1.701.0_0 (active) jpeg @6b_1 (active) kdelibs3 @3.5.6_0+darwin_8 (active) libart_lgpl @2.3.19_1 (active) libiconv @1.10_1+darwin_8 (active) libidn @0.6.11_0+darwin_8 (active) libpixman @0.1.6_0 (active) libpng @1.2.10_2+darwin_8 (active) libtool @1.5.24_0 (active) libxml2 @2.6.28_1 (active) libxslt @1.1.20_0 (active) lua @5.1.2_0 (active) m4 @1.4.9_0 (active) ncurses @5.6_0+darwin_8 (active) ncursesw @5.6_0+darwin_8 (active) openexr @1.4.0_0 (active) openssl @0.9.8e_0+darwin_8 (active) p5-locale-gettext @1.05_0 (active) pango @1.12.3_0 (active) pcre @7.1_1+utf8 (active) perl5.8 @5.8.8_0+darwin_8 (active) pkgconfig @0.20_0 (active) qt3 @3.3.8_0+darwin_8 (active) readline @5.2.001_0 (active) render @0.9_0 (active) tiff @3.8.2_0+darwin_8 (active) unsermake @0.4-20060316_0 (active) XFree86 @4.5.0_2 Xft2 @2.1.7_0 (active) xpm @3.4k_0 xrender @0.9.0_0+darwin_8 (active) zlib @1.2.3_0 (active) Any ideas? B.W

by Unregistered Visitor on 07/16/07

Umbrello version

I note that 1.5.7 has been officially released, and now superceded by 1.5.71 - can you confirm what version of source you are trying to compile?

by Mark Aufflick on 07/19/07


In your notes you mention "Apple's developer tools and Then you need an installation of MacPorts". I am new to the Mac environment; here are several questions: 1. What are the developer tool needed and how one can install them? 2. X11 is already installed for OpenOffice; is that what you ment with 3. Last, the link you have for MacPort is not working, where would be a good place to get it? Thank you in advance, Arnon;

by Unregistered Visitor on 08/07/07

Prerequisites for Umbrello

Hi Arnon - welcome to the Mac! Yes, X11 that you need you alread have for OpenOffice. You will have recieved Developer Tools on either CD or DVD with your Mac. In any case, you can download the latest version by registering at but look out, the download will be the better part of a Gigabyte. Macports: and I fixed the blog entry.

by Mark Aufflick on 08/08/07

Failed installation of kdelibs3

Dear Mark. I followed your instructions but the command "sudo port install qt3 kdelibs3" didn't complete its job. qt3 with all its dependencies was installed without any problem, but the kdelibs3 wasn't so successful. Here's the last few messages I got from the port command. ... ---> Extracting readline ---> Applying patches to readline ---> Configuring readline ---> Building readline with target all ---> Staging readline into destroot ---> Installing readline 5.2.001_0 ---> Activating readline 5.2.001_0 ---> Cleaning readline ---> Fetching lua ---> Attempting to fetch lua-5.1.2.tar.gz from ---> Verifying checksum(s) for lua ---> Extracting lua ---> Applying patches to lua ---> Configuring lua ---> Building lua with target macosx ---> Staging lua into destroot Error: violation by /opt/local/man Error: Target org.macports.destroot returned: mtree violation! Error: The following dependencies failed to build: lua openexr openssl pcre tiff unsermake coreutils Error: Status 1 encountered during processing. Here's more context for you: 1. I am working on a PowerBook G4 running MAC OS X 10.4.10. X11 is set up and runs nicely. 2. I tried installing each of the remaining dependencies independently and they all succeed ... so the problem seems to be with "lua". Maybe I should get "lua" from somewhere else? Any advice? M.Z.

by Unregistered Visitor on 08/15/07

Looks like a MacPorts problem

Hi M.Z., Looks like this is a new check applied by MacPorts: In the next version of MacPorts they are going to change it to a warning instead of an error, but ultimately the maintainer of the lua port needs to fix the actual issue. You might try contacting the lua maintainer yourself - you should be able to track that down on

by Mark Aufflick on 08/15/07

Building kdelibs3 (part 2)

I forced macports to disregard the violation errors (as suggested on the web-site you mentioned) and things got better. Just out of curiosity, how long did it take you to build kdelibs3 (and on what type of machine)? Is it reasonable to wait three hours (on a G4)? Would twelve hours be too much? I run "sudo port install -v -d kdelibs3", but after few seconds of frantic messaging the system got stuck in what seems to be a long compilation. Anyway, just tell me "Don't worry, it just takes ages!" and I'll leave the G4 huffing and puffing for a day or two. M.Z.

by Unregistered Visitor on 08/16/07

Don't worry, it just takes ages!

I don't remember exactly, but I remember it being a few hours at least on a G4 laptop. I may well have started the compile and gone to bed. You should be able to tell if stuff is happening by running top -ocpu which will show you current system activity sorted by cpu utilisation. You should see cc or some other compilation type program chewing up most of your cpu. If so - let it run. If not, it could be stuck.

by Mark Aufflick on 08/29/07

Leopard troubles

For anyone having problems compiling umbrello in Leopard, juse use this ./configure line: env LDFLAGS=-Wl,-dylib_file,/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries /libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib ./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts

by Unregistered Visitor on 11/10/07

Kde-config was not found

checking build system type... i686-apple-darwin9.1.0 checking host system type... i686-apple-darwin9.1.0 checking target system type... i686-apple-darwin9.1.0 checking for a BSD-compatible install... /usr/bin/install -c checking for -p flag to install... yes checking whether build environment is sane... yes checking for a thread-safe mkdir -p... admin/install-sh -c -d checking for gawk... no checking for mawk... no checking for nawk... no checking for awk... awk checking whether make sets $(MAKE)... yes checking for kde-config... not found configure: error: The important program kde-config was not found! Please check whether you installed KDE correctly. ---------------------------------------------------------------------------------- Can someone help me, pls? Kdelibs3's install dont take any error, and i dont know why i take that error Thanks

by Unregistered Visitor on 11/21/07

re: Leopard troubles

Could you elaborate on your comment? I get the error: ld: cycle in dylib re-exports with /usr/X11/lib/libGL.dylib which your fix probably solves, but its not working. Also, in configure I have this line: checking for X... libraries /usr/X11/lib, headers /usr/X11/include should that be pointing somewhere else for X? do I need to do something after this: LDFLAGS=-Wl,-dylib_file,/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries /libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib so the system recognizes the changes? Thanks!

by Unregistered Visitor on 11/28/07

Installation of kdelibs3 failed

Hello Mark, Am using PowerBook G4 and i ve Tiger 10.4.10 . I did follow your instructions and typed in "sudo port install qt3 kdelibs3" wich gives the following error !!!! Warning: Can't open index file for source: rsync:// Error: search for portname qt3 failed: No index(es) found! Have you synced your source indexes? Am not able to figure out the Problem. please help.

by Unregistered Visitor on 01/23/08

macport selfupdate

Hi, Sounds like you just installed MacPorts for the first time? Before you can install any software with macports, it needs an up to date port database. Try: sudo port selfupdate And then do the install after that.

by Mark Aufflick on 01/24/08

Updated configure command under Leopard

The above configure command recommended for Leopard didn't work for me. QT's "moc" and "uic" were not found. I added the following which did work:

MOC=/opt/local/lib/qt3/bin/moc UIC_PATH=/opt/local/lib/qt3/bin/uic

So the new command is:

env LDFLAGS=-Wl,-dylib_file,/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib MOC=/opt/local/lib/qt3/bin/moc UIC_PATH=/opt/local/lib/qt3/bin/uic ./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts
I'm no shell expert so I don't totally understand the configure script. There's probably a single, more generic env variable to manipulate so configure will find these binaries.

by Unregistered Visitor on 03/01/08

(anonymous == nemonik) Getting past the X11 issue on Leopard

set LDFLAGS="-Wl,-dylib_file,/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib:/System/Library/Frameworks/OpenGL.framework/Versions/A/Libraries/libGL.dylib MOC=/opt/local/lib/qt3/bin/moc UIC_PATH=/opt/local/lib/qt3/bin/uic"

./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts --x-libraries=/usr/X11R6/lib --x-includes=/usr/X11R6/include/X11


sudo make install

note, /usr/X11R6 is a link to /usr/X11.

and this works for me.

by Unregistered Visitor on 04/30/08

Umbrello build failed


I am trying to build Umbrello on Mac Book (Mac OS X 10.5.6) following your instruction. I got an error halfway and build halted:

/bin/sh ../../libtool --silent --tag=CXX --mode=link g++ -Wno-long-long -Wundef -Wall -W -Wpointer-arith -O2 -Wno-non-virtual-dtor -fno-exceptions -fno-check-new -fno-common -DQT_CLEAN_NAMESPACE -DQT_NO_ASCII_CAST -DQT_NO_STL -DQT_NO_COMPAT -DQT_NO_TRANSLATION -L/opt/local/lib -L/opt/local/lib/qt3/ -L/usr/X11/lib -L/opt/local/lib -o umbodoc main.o -lkdecore -L/opt/local/lib -lxslt -lxml2 -lz -lpthread -liconv -lm -L/opt/local/lib -lxml2 -lz -lpthread -liconv -lm
ld: warning, duplicate dylib /opt/local/lib/libz.1.dylib
ld: cycle in dylib re-exports with /usr/X11/lib/libGL.dylib
collect2: ld returned 1 exit status
make[3]: *** [umbodoc] Error 1
make[2]: *** [all-recursive] Error 1
make[1]: *** [all-recursive] Error 1
make: *** [all] Error 2

Can you please help?

by Unregistered Visitor on 02/16/09

Problem to install Umbrello on my MBP


I just copied and paste the installation command from and got the following error which I've been trying to find a solution.

Thanks in advance for any help!

genesis-5@~]sudo port install qt3 kdelibs3
---> Computing dependencies for qt3
---> Activating expat @2.0.1_0
Error: The following dependencies failed to build: Xft2 expat fontconfig freetype zlib libiconv gperf pkgconfig xorg-xproto xrender xorg-libX11 autoconf help2man gettext ncurses ncursesw p5-locale-gettext perl5 perl5.8 m4 automake libtool xorg-bigreqsproto xorg-inputproto xorg-kbproto xorg-libXau xorg-libXdmcp xorg-util-macros xorg-xcmiscproto xorg-xextproto xorg-xf86bigfontproto xorg-xtrans xorg-renderproto jpeg libpng mesa glut makedepend tcl xorg-dri2proto xorg-glproto xorg-libXfixes xorg-fixesproto xorg-libXi xorg-libXext xorg-libXmu xorg-libXt xorg-libsm xorg-libice xorg-libXcursor xorg-libXinerama xorg-xineramaproto xorg-libXrandr xorg-randrproto
Error: Status 1 encountered during processing.

by Unregistered Visitor on 09/29/09

macbook + qt3, not working either

hey! i've got the same error than the last post. on macbook thou. haven't got any clue what to do next... cheers.

by Unregistered Visitor on 11/02/09


just wanted to say thank you to the OP and everyone else who took the time to comment. got it working no probs on my old MBP (3,1) with snow leopard. easy! oh and ... ports install takes a while and makes the fan whine a bit!

by Unregistered Visitor on 03/04/10



by Unregistered Visitor on 01/19/11

Umbrello on leopard


I work at the office of umbrello with Kubuntu, but at home I'm on Mac. I work on MacOS X 10.6.8 and I have Xcode 3.6. installing KDE works quite, but I can not compile a umbrello. The control line : ./configure --prefix=/opt/local --with-qt-includes=/opt/local/include/qt3/ --with-qt-libraries=/opt/local/lib/qt3/ --with-extra-libs=/opt/local/lib --with-extra-includes=/opt/local/include --without-arts

give me the answer

checking for X... configure: error: Can't find X libraries. Please check your installation and add the correct paths!

I know that X11 works, but I do not know the path ... if you could help me. thank you


by Unregistered Visitor on 09/29/11

umbrello is now an available port on macPorts

this provides an easy one step process sudo port install umbrello

by Unregistered Visitor on 10/14/13

Add comment