Take the 2-minute tour ×
Ask Ubuntu is a question and answer site for Ubuntu users and developers. It's 100% free, no registration required.

Consider adjusting the PKG_CONFIG_PATH environment variable if you installed software in a non-standard prefix. What does this mean ?

share|improve this question
I would almost ask this the same way except you could have asked for examples of the proper usage of PKG_CONFIG_PATH environment variable like "what is it and how do I use it?" It seems like the answers you got were trying to tell you this. I'm finding this show up a lot during ./configure when it fails to find dependencies. –  Douglas G. Allen Oct 25 '14 at 4:08

7 Answers 7

The first answer is not technically explicit enough. From the man page (open a terminal, type man pkg-config):

pkg-config retrieves information about packages from special metadata files. These files are named after the package, and has a .pc extension. On most systems, pkg-config looks in /usr/lib/pkgconfig, /usr/share/pkgconfig, /usr/local/lib/pkgconfig and /usr/local/share/pkgconfig for these files. It will additionally look in the colon-separated (on Windows, semicolon-separated) list of directories specified by the PKG_CONFIG_PATH environment variable.

So the pkg-config program is not in the PKG_CONFIG_PATH directory; however, if you install a library, for the information to use it in an automake script to be accessible it needs to be in a directory pkg-config is aware of.

share|improve this answer

PKG_CONFIG_PATH is a environment variable which holds the path of pkg-config script. pkg-config program is used to retrieve information about installed libraries in the system.

To find the path use the command

locate pkg-config

and your results will be something like this


To check the PKG_CONFIG_PATH value use the command echo $PKG_CONFIG_PATH

To set the PKG_CONFIG_PATH value use export PKG_CONFIG_PATH=/usr/lib/pkgconfig

share|improve this answer
If I have enough rep I'd downvote this. In short, this answer is completely wrong. See @IanMartin's answer and man page. The variable containing the path of pkg-config is usually called $PKG_CONFIG on autotools systems at least. –  Timothy Gu Jan 1 at 6:22
How is this the top answer? It's plain wrong. –  remram Jan 14 at 19:26

To see where pkg-config (version 0.24 or later) searches for installed libraries by default, use the following command:

pkg-config --variable pc_path pkg-config

To modify that path, set the PKG_CONFIG_PATH environment variable. The man file states PKG_CONFIG_PATH is:

A colon-separated (on Windows, semicolon-separated) list of directories to search for .pc files. The default directory will always be searched after searching the path; the default is libdir/pkgconfig:datadir/pkgconfig where libdir is the libdir where pkg-config and datadir is the datadir where pkg-config was installed.

share|improve this answer
a useful script will be echo $(pkg-config --variable pc_path pkg-config)${PKG_CONFIG_PATH:+:}${PKG_CONFIG_PATH} –  albfan Mar 5 at 22:13

You're trying to build a piece of software, let's say Widget. Widget relies on another library, libcog for the sake of argument. Widget's build process (probably a configure script) is using pkg-config to determine how to use libcog. pkg-config doesn't know anything about libcog.

If libcog isn't installed, that's your problem. There is a good chance that a standard install of libcog will fix the problem. Depending on your system, you may need to install an addition "developer" version of the package; it often has "-devel" or "-dev" at the end, so if you install "libcog", you might also need to install "libcog-devel".

If libcog is installed, it's probably not installed in a way that pkg-config can find it. There is probably a libcog.pc file somewhere on your system. For the sake of argument, it's at /opt/cog/lib/pkgconfig/libcog.pc. In that case, you can tell pkg-config about it by setting the PKG_CONFIG_PATH to the directory holding libcog.pc. So in a Bourne shell or similar, something like

export PKG_CONFIG_PATH=/opt/cog/lib/pkgconfig/

Once that's done, re-running the command that failed will hopefully work.

If libcog is installed, including the libraries and header files, and you don't have a libcog.pc file, things are going poorly. Presumably a standard install of libcog includes the information, or else Widget wouldn't rely on it. I'd first investigate reinstalling libcog. It is possible to manually create the libcog.pc file, but getting it right is difficult and highly specific to a given library.

share|improve this answer

It means you're trying to build something from source, and it can't find all of the dependencies it needs. The pkg-config script it uses to find the development files for those libraries, outputs this message.

share|improve this answer

I looked at the man-page on my 64-bit system and got a bit confused. It said in one line:

pkg-config retrieves information about packages from special metadata files. These files are named after the package, with the extension .pc. By default, pkg-config looks in the direc‐ tory prefix/lib/pkgconfig for these files; it will also look in the colon-separated (on Windows, semicolon-separated) list of directories specified by the PKG_CONFIG_PATH environment vari‐ able.

I had assumed that it alwas looks in the directories lib/pkgconfig. Turns out its the directories themselves. In my case, I was trying to compile the hello world gtk tutorial. I locate the file i want e.g.

locate gtk | grep '\.pc'

Among the results are:


Finally was to do an export.

export PKG_CONFIG_PATH=/usr/lib/x86_64-linux-gnu/pkgconfig/
share|improve this answer

It seems to me that most of the answers have too much information than needed.

The software that one installs may (and usually does) rely on some libraries and/or headers and the System uses pkg-config to find them.

Said so, pkg-config looks for this files in pre-defined (default) system's directories. Those folders are "prefix". E.g. a library that has prefix /usr/local is expected to have headers in /usr/local/include, and the library itself will be in /usr/local/lib. pkg-config however looks for libraries also in directory listed in the environment variable PKG_CONFIG_PATH.

Then if you install software outside the default list of folders you had to "adjust" the list, namely add your directories to PKG_CONFIG_PATH

$ export PKG_CONFIG_PATH=$PKG_CONFIG_PATH:<your-directory>

For more info, you can look here and here

share|improve this answer

Your Answer


By posting your answer, you agree to the privacy policy and terms of service.

Not the answer you're looking for? Browse other questions tagged or ask your own question.