Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions |

# Installing Qt/X11

You may need to be root, depending on the permissions of the directories where you choose to install Qt.

1. Unpack the archive if you have not done so already:

           cd /usr/local
           gunzip qt-x11-version.tar.gz    # uncompress the archive
           tar xf qt-x11-version.tar       # unpack it

   This creates the directory /usr/local/qt-version containing the files from the main archive.

   Rename qt-version to qt (or make a symlink):

           mv qt-version qt

   The rest of this file assumes that Qt is installed in `/usr/local/qt`.

2. Set some environment variables in the file `.profile` (or `.login`, depending on your shell) in your home directory. Create the file if it is not there already.

   - QTDIR -- the directory in which you're building Qt
   - PATH -- to locate the moc program and other Qt tools
   - MANPATH -- to access the Qt man pages
   - LD_LIBRARY_PATH -- for the shared Qt library

   This is done like this:

   In `.profile` (if your shell is bash, ksh, zsh or sh), add the following lines:

           QTDIR=/usr/local/qt
           PATH=$QTDIR/bin:$PATH
           MANPATH=$QTDIR/man:$MANPATH
           LD_LIBRARY_PATH=$QTDIR/lib:$LD_LIBRARY_PATH

           export QTDIR PATH MANPATH LD_LIBRARY_PATH

   In `.login` (in case your shell is csh or tcsh), add the following lines:

           setenv QTDIR /usr/local/qt
           setenv PATH $QTDIR/bin:$PATH
           setenv MANPATH $QTDIR/man:$MANPATH
           setenv LD_LIBRARY_PATH $QTDIR/lib:$LD_LIBRARY_PATH

   After you have done this, you will need to login again, or re-source the profile before continuing, so that at least `$QTDIR` is set. The installation will give an error message and not proceed otherwise.

   On AIX set LIBPATH and on HP-UX set SHLIB_PATH instead of LD_LIBRARY_PATH.

   Note that the SGI MIPSpro o32 and Sun WorkShop 5.0 targets are no longer supported as of Qt 3.3.

3. Install your license file as `$HOME/.qt-license`. For the free edition and evaluation version, you do not need a license file.

4. Compile the Qt library, and build the example programs, the tutorial and the tools (e.g. Qt Designer) as follows.

   Type:

           ./configure

   This will configure the Qt library for your machine. Note that GIF support is turned off by default. Run `./configure -help` to get a list of configuration options. Read `PLATFORMS` for a list of supported platforms.

   To create the library and compile all examples and the tutorial:

           make

   If you have problems, see http://www.trolltech.com/platforms/.

5. In very few cases you may need to run `/sbin/ldconfig` or something similar at this point if you are using shared libraries.

   If you have problems running the example programs, e.g. messages like

           can't load library 'libqt.so.2'

   you probably need to put a reference to the qt library in a configuration file and run `/sbin/ldconfig` as root on your system. And don't forget to `set` LD_LIBRARY_PATH as explained in 2) above.

6. The online HTML documentation is installed in `/usr/local/qt/doc/html/` The main page is `/usr/local/qt/doc/html/index.html`. The man pages are installed in `/usr/local/qt/doc/man/`. The documentation is also accessible using Qt Assistant.

You're done. Qt is now installed.