<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:content="http://purl.org/rss/1.0/modules/content/">
  <channel>
    <title>Gitlab on D. Sébastien Taggart</title>
    <link>https://www.sebastientaggart.com/tags/gitlab/</link>
    <description>Recent content in Gitlab on D. Sébastien Taggart</description>
    <generator>Hugo</generator>
    <language>en</language>
    <lastBuildDate>Sun, 04 Oct 2026 22:13:05 -0400</lastBuildDate>
    <atom:link href="https://www.sebastientaggart.com/tags/gitlab/index.xml" rel="self" type="application/rss+xml" />
    <item>
      <title>How to Downgrade PostgreSQL from 11 to 9 to Fix &#34;pg_dump: Aborting Because of Server Version Mismatch&#34; Error</title>
      <link>https://www.sebastientaggart.com/writing/downgrade-postgresql-11-to-9-to-fix-pg_dump-server-version-mismatch/</link>
      <pubDate>Sun, 21 Apr 2019 13:46:16 -0500</pubDate>
      <guid>https://www.sebastientaggart.com/writing/downgrade-postgresql-11-to-9-to-fix-pg_dump-server-version-mismatch/</guid>
      <description>&lt;p&gt;In the world of GitLab and PostgreSQL, compatibility is crucial. When using GitLab Omnibus, you&amp;rsquo;ll find it ships with PostgreSQL 9.6. However, if you&amp;rsquo;re leveraging an external PostgreSQL database container, it&amp;rsquo;s essential to adhere to a key requirement: GitLab only supports the exact version of PostgreSQL internally and externally. This subtlety often gets lost in the shuffle, especially for those new to the ecosystem. To put it plainly, if you&amp;rsquo;re running a Docker installation of GitLab, you must use PostgreSQL 9.6—no more, no less.&lt;/p&gt;</description>
      <content:encoded><![CDATA[<p>In the world of GitLab and PostgreSQL, compatibility is crucial. When using GitLab Omnibus, you&rsquo;ll find it ships with PostgreSQL 9.6. However, if you&rsquo;re leveraging an external PostgreSQL database container, it&rsquo;s essential to adhere to a key requirement: GitLab only supports the exact version of PostgreSQL internally and externally. This subtlety often gets lost in the shuffle, especially for those new to the ecosystem. To put it plainly, if you&rsquo;re running a Docker installation of GitLab, you must use PostgreSQL 9.6—no more, no less.</p>
<h2 id="tldr">TL;DR:</h2>
<p>To address the version mismatch error, run a Python script against your PostgreSQL 11 dump to remove <code>AS integer</code> from <code>CREATE SEQUENCE</code> statements, then proceed with the import as usual.</p>
<h2 id="setting-the-scene">Setting the Scene</h2>
<p>Consider a <code>docker-compose.yml</code> file that resembles the following (note that some details are intentionally obfuscated for clarity):</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-yaml" data-lang="yaml"><span class="line"><span class="cl"><span class="nt">version</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;3.5&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="nt">services</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">gitlab</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;gitlab/gitlab-ce:latest&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;gitlab&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">always</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">hostname</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;git.sebastientaggart.com&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">environment</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span><span class="nt">GITLAB_OMNIBUS_CONFIG</span><span class="p">:</span><span class="w"> </span><span class="p">|</span><span class="sd">
</span></span></span><span class="line"><span class="cl"><span class="sd">        external_url &#39;https://git.sebastientaggart.com&#39;
</span></span></span><span class="line"><span class="cl"><span class="sd">        # Other configurations...</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">ports</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s1">&#39;3000:3000&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s1">&#39;10022:22&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s1">&#39;./data/gitlab/config:/etc/gitlab&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s1">&#39;./data/gitlab/logs:/var/log/gitlab&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="s1">&#39;./data/gitlab/data:/var/opt/gitlab&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">  </span><span class="nt">postgresql-gitlab</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">image</span><span class="p">:</span><span class="w"> </span><span class="s1">&#39;postgres:11.1-alpine&#39;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">container_name</span><span class="p">:</span><span class="w"> </span><span class="s2">&#34;gitlab_postgresql&#34;</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">restart</span><span class="p">:</span><span class="w"> </span><span class="l">always</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">environment</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">POSTGRES_USER=gitlab</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">POSTGRES_PASSWORD={PASSWORD}</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">POSTGRES_DB=gitlab</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">    </span><span class="nt">volumes</span><span class="p">:</span><span class="w">
</span></span></span><span class="line"><span class="cl"><span class="w">      </span>- <span class="l">./data/postgresql-gitlab:/var/lib/postgresql/data</span><span class="w">
</span></span></span></code></pre></div><p>If you attempt to back up the database using the typical command, such as:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker <span class="nb">exec</span> -t gitlab gitlab-rake gitlab:backup:create
</span></span></code></pre></div><p>You might encounter the following error:</p>
<pre tabindex="0"><code>Dumping PostgreSQL database gitlab ... pg_dump: server version: 11.1; pg_dump version: 9.6.11
pg_dump: aborting because of server version mismatch
</code></pre><h2 id="extracting-the-database-dump">Extracting the Database Dump</h2>
<p>To resolve this issue, you&rsquo;ll need to access the PostgreSQL container and upgrade the PostgreSQL client to version 11. Here’s how:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl"><span class="nb">echo</span> <span class="s2">&#34;deb http://apt.postgresql.org/pub/repos/apt/ stretch-pgdg main&#34;</span> &gt;&gt; /etc/apt/sources.list.d/pgdg.list
</span></span><span class="line"><span class="cl">sh -c <span class="s1">&#39;echo &#34;deb http://apt.postgresql.org/pub/repos/apt/ xenial-pgdg main&#34; &gt; /etc/apt/sources.list.d/pgdg.list&#39;</span>
</span></span><span class="line"><span class="cl">apt install wget ca-certificates
</span></span><span class="line"><span class="cl">wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc <span class="p">|</span> apt-key add -
</span></span><span class="line"><span class="cl">apt update
</span></span><span class="line"><span class="cl">apt install postgresql-client
</span></span><span class="line"><span class="cl">ln -s /usr/bin/psql /usr/bin/pg_dump /opt/gitlab/bin/
</span></span></code></pre></div><p>With the client upgraded, you can now carry out the export with the following command:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">docker <span class="nb">exec</span> -t gitlab_postgresql pg_dumpall -c -U gitlab &gt; dump_11_<span class="k">$(</span>date +%d-%m-%Y<span class="s2">&#34;_&#34;</span>%H_%M_%S<span class="k">)</span>.sql
</span></span></code></pre></div><p>Remember, this command is executed directly against the PostgreSQL container, not through the usual rake command, as we are preparing to downgrade PostgreSQL back to 9.6.</p>
<h2 id="managing-data-between-operations">Managing Data Between Operations</h2>
<p>In my scenario, I&rsquo;ve been using a volume for the PostgreSQL data directory to keep the database intact between container resets. Before switching to an older PostgreSQL version in your <code>docker-compose.yml</code>, you&rsquo;ll need to clean out the data directory:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">sudo rm -rf /opt/docker/gitlab/data/postgresql-gitlab/*
</span></span></code></pre></div><h2 id="downgrading-from-10-to-9">Downgrading from 10 to 9</h2>
<p>Exporting from PostgreSQL 11 and importing into 10 usually goes smoothly. However, moving from 10 to 9 can lead to database errors. Fortunately, a simple Python script can help us navigate this issue, as referenced in <a href="https://stackoverflow.com/questions/49547602/cant-import-postgresql10-dump-into-9-6-database">this Stack Overflow discussion</a>:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-python" data-lang="python"><span class="line"><span class="cl"><span class="ch">#!/usr/bin/env python3</span>
</span></span><span class="line"><span class="cl"><span class="kn">import</span> <span class="nn">sys</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="c1"># Downgrades pg_dump 10 script to 9.x</span>
</span></span><span class="line"><span class="cl"><span class="c1"># removing &#39;AS integer&#39; from &#39;CREATE SEQUENCE&#39; statement</span>
</span></span><span class="line"><span class="cl">
</span></span><span class="line"><span class="cl"><span class="n">inside_create_sequence</span> <span class="o">=</span> <span class="kc">False</span>
</span></span><span class="line"><span class="cl"><span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">sys</span><span class="o">.</span><span class="n">stdin</span><span class="o">.</span><span class="n">readlines</span><span class="p">():</span>
</span></span><span class="line"><span class="cl">    <span class="k">if</span> <span class="n">inside_create_sequence</span> <span class="ow">and</span> <span class="n">row</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span> <span class="o">==</span> <span class="s1">&#39;as integer&#39;</span><span class="p">:</span>
</span></span><span class="line"><span class="cl">        <span class="k">pass</span>
</span></span><span class="line"><span class="cl">    <span class="k">else</span><span class="p">:</span>
</span></span><span class="line"><span class="cl">        <span class="nb">print</span><span class="p">(</span><span class="n">row</span><span class="p">,</span> <span class="n">end</span><span class="o">=</span><span class="s1">&#39;&#39;</span><span class="p">,</span> <span class="n">flush</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
</span></span><span class="line"><span class="cl">    <span class="n">inside_create_sequence</span> <span class="o">=</span> <span class="n">row</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span><span class="o">.</span><span class="n">startswith</span><span class="p">(</span><span class="s1">&#39;CREATE SEQUENCE &#39;</span><span class="p">)</span>
</span></span></code></pre></div><p>Save this script as <code>pgdump_10_to_9.py</code>, make it executable, and run it:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">cat dump_10_12-04-2019_15_09_16.sql <span class="p">|</span> ./pgdump_10_to_9.py &gt; dump_9_compatible.sql
</span></span></code></pre></div><p>After that, update your <code>docker-compose.yml</code> to leverage a PostgreSQL 9.6 image and import your cleaned-up dump:</p>
<div class="highlight"><pre tabindex="0" class="chroma"><code class="language-bash" data-lang="bash"><span class="line"><span class="cl">cat dump_9_compatible.sql <span class="p">|</span> docker <span class="nb">exec</span> -i gitlab_postgresql psql -U gitlab
</span></span></code></pre></div><p>And just like that, you’ve successfully downgraded to a version of PostgreSQL that’s more compatible with GitLab.</p>
<p>By approaching the downgrade methodically, you can navigate the complexities of version compatibility with confidence. Remember, clarity in your setup can save you from numerous headaches down the line.</p>
]]></content:encoded>
    </item>
  </channel>
</rss>
