Unix and Linux
| Chapter 2. Installation |

## Unix and Linux

### Prebuilt Packages

Recent versions of gtkmm are packaged by nearly every major Linux distribution these days. So, if you use Linux, you can probably get started with gtkmm by installing the package from the official repository for your distribution. Distributions that include gtkmm in their repositories include Debian, Ubuntu, Red Hat, Fedora, Mandriva, Suse, and many others.

The names of the gtkmm packages vary from distribution to distribution (e.g. libgtkmm-3.0-dev on Debian and Ubuntu or gtkmm30-devel on Red Hat Fedora), so check with your distribution's package management program for the correct package name and install it like you would any other package.

| Note
The package names will not change when new API/ABI-compatible versions of gtkmm are released. Otherwise they would not be API/ABI-compatible. So don't be surprised, for instance, to find gtkmm 3.24 supplied by Debian's libgtkmm-3.0-dev package.

### Installing From Source

If your distribution does not provide a pre-built gtkmm package, or if you want to install a different version than the one provided by your distribution, you can also install gtkmm from source. The source code for gtkmm can be downloaded from https://download.gnome.org/sources/gtkmm/.

After you've installed all of the dependencies, download the gtkmm source code, unpack it, and change to the newly created directory. gtkmm 3.24.2 and earlier can be built and installed with the following sequence of commands:

    # ./configure
    # make
    # make install

gtkmm 3.24.3 and later can be built with Meson. See the `README` file in the gtkmm version you've downloaded.

| Note
Remember that on a Unix or Linux operating system, you will probably need to be `root` to install software. The su or sudo command will allow you to enter the `root` password and have `root` status temporarily.

The `configure` script or meson will check to make sure all of the required dependencies are already installed. If you are missing any dependencies, it will exit and display an error.

By default, gtkmm if built with Meson or Autotools, will be installed under the `/usr/local` directory. On some systems you may need to install to a different location. For instance, on Red Hat Linux systems you might use the `--prefix` option with configure, like one of:

    # meson setup --prefix=/usr <builddir> <srcdir>
    # meson configure --prefix=/usr
    # ./configure --prefix=/usr

| Warning
You should be very careful when installing to standard system prefixes such as `/usr`. Linux distributions install software packages to `/usr`, so installing a source package to this prefix could corrupt or conflict with software installed using your distribution's package-management system. Ideally, you should use a separate prefix for all software you install from source.

If you want to help develop gtkmm or experiment with new features, you can also install gtkmm from git. Most users will never need to do this, but if you're interested in helping with gtkmm development, see the Working with gtkmm's Source Code appendix.

Chapter 2. Installation |  | Microsoft Windows