September 26, 2024: PostgreSQL 17 Released!
Unsupported versions: 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2 / 7.1
This documentation is for an unsupported version of PostgreSQL.
You may want to view the same page for the current version, or one of the other supported versions listed above instead.

Chapter 15. Client-Only Installation on Windows

Although a complete PostgreSQL installation for Windows can only be built using MinGW or Cygwin, the C client library (libpq) and the interactive terminal (psql) can be compiled using other Windows tool sets. Makefiles are included in the source distribution for Microsoft Visual C++ and Borland C++. It should be possible to compile the libraries manually for other configurations.

Tip: Using MinGW or Cygwin is preferred. If using one of those tool sets, see Chapter 14.

To build everything that you can on Windows using Microsoft Visual C++, change into the src directory and type the command

nmake /f win32.mak

This assumes that you have Visual C++ in your path.

To build everything using Borland C++, change into the src directory and type the command

make -N -DCFG=Release /f bcc32.mak

The following files will be built:

interfaces\libpq\Release\libpq.dll

The dynamically linkable frontend library

interfaces\libpq\Release\libpqdll.lib

Import library to link your programs to libpq.dll

interfaces\libpq\Release\libpq.lib

Static version of the frontend library

bin\psql\Release\psql.exe

The PostgreSQL interactive terminal

Normally you do not need to install any of the client files. You should place the libpq.dll file in the same directory as your applications .EXE-file. Only if this is for some reason not possible should you install it in the WINNT\SYSTEM32 directory (or in WINDOWS\SYSTEM on a Windows 95/98/ME system). If this file is installed using a setup program, it should be installed with version checking using the VERSIONINFO resource included in the file, to ensure that a newer version of the library is not overwritten.

If you plan to do development using libpq on this machine, you will have to add the src\include and src\interfaces\libpq subdirectories of the source tree to the include path in your compiler's settings.

To use the library, you must add the libpqdll.lib file to your project. (In Visual C++, just right-click on the project and choose to add it.)

Free development tools from Microsoft can be downloaded from http://msdn.microsoft.com/visualc/vctoolkit2003/. You will also need MSVCRT.lib from the platform SDK from http://www.microsoft.com/msdownload/platformsdk/sdkupdate/. You can also download the .NET framework from http://msdn.microsoft.com/netframework/downloads/updates/default.aspx. Once installed, the toolkit binaries must be in your path, and you might need to add a /lib:<libpath> to point to MSVCRT.lib. Free Borland C++ compiler tools can be downloaded from http://www.borland.com/products/downloads/download_cbuilder.html#, and require similar setup.