# Installation

## General Instructions

The easiest way to install Umbrello is to get a pre-compiled binary package (rpm, deb) for your system. If you prefer to compile your applications yourself or are running a system for which there are no binary packages, you can download the sources and follow the instructions for source installations.

We understand that for many users it is difficult to install a program from sources, so we try to build pre-compiled packages for the systems/distributions we have access to. If you want to install Umbrello from a binary package you can check if there is a pre-compiled package available for your platform at Umbrello's home page. There we will publish the packages we can make ourselves, as well as packages made by 3rd parties for the systems we do not have access to.

If you can make a binary package for a distribution for which there are currently no packages available at our site, please consider contacting the Umbrello developers and contributing your package so that other users can benefit from it.

## Binary Package Installation

To install Umbrello from a pre-compiled package, use the package management program that came with your system. You can also call the package manager directly from the command line. For example, to install a deb package change to the directory where you downloaded the file and enter the following command:

    % dpkg -i umbrello-1.1-i386.deb

In case of rpm packages the command to enter is

    % rpm -i umbrello-1.1-i386.rpm

For other platforms, please consult the documentation provided with your system.

## Source Installation

When installing from sources it is important that you check the README and INSTALL files for the latest information on this program.

In order to install the program, the first step is to unpack the sources so that you can build them. To do this, cd into the directory where you downloaded the archive file and execute the following command.

    % tar -xvzf umbrello-1.1.tar.gz

This will create a new directory into which all source files are contained.

The next step is to change into this new directory to configure and build the program. For this you need to execute following commands:

    % ./configure --prefix=<path to your KDE base directory here>
    % make

Please substitute the correct path for your base KDE installation in the --prefix, as this will make sure Umbrello finds all the files and libraries it needs to work correctly when you install it.

When the build process finishes, the only thing left to do is to install the files to their final destination. Normally you will need root access for this, in which case you should execute

    % su

and then enter the root password. To finally install the program simply type

    % make install

## Starting the program

Once you have installed Umbrello, you can run it from any command line by typing

    % umbrello

Or by selecting the entry from the KDE menu. The program is located under the Development menu as Umbrello UML Modeller.

Umbrello's main window The main Window of Umbrello

The main Window of Umbrello