Out of tree builds

April 27, 2017

Recently I was asked “what’s a vpath build?” If you regularly build postgres from source it’s something you should know about. A vpath build is one where the build tree is kept completely separate from the source tree, so you can completely remove the build tree and your source tree is still there, clean and pristine. It’s very easy to set up unless you’re building with the Microsoft toolset. Essentially what you do is create the root of your build tree, change directory into that directory, and then call configure in your source tree from there.  configure knows all about setting up the vpath tree and does all the work for you. After that, you just run make etc just like you would normally. So it looks like this:

mkdir mybuild
cd mybuild
/path/to/postgresql-source/configure
make

You can even do this inside your source tree, so that mybuild is a subdirectory of the postgresql source root.

Another advantage of this is that if you’re working on several git  branches at once in a given work tree, you can keep a build tree for each branch and then switch between branches.

The Buildfarm client has support for this type of build in its configuration file, and it’s actually the most efficient way to run the client.

Share this

More Blogs

RAG app with Postgres and pgvector

Build a RAG app using Postgres and pgvector to enhance AI applications with improved data management, privacy, and efficient local LLM integration.
October 08, 2024

Mastering PostgreSQL in Kubernetes with CloudNativePG

Previewing EDB’s training session for PGConf.EU 2024, presented by our Kubernetes experts EDB is committed to advancing PostgreSQL by sharing our expertise and insights, especially as the landscape of database...
September 30, 2024