Mar 22, 2017 - Victor Wu    

GitLab 9.0 released with Subgroups and Deploy Boards

GitLab 9.0 Released with Subgroups, Deploy Boards, Export Issues, Environment Monitoring, and much more!

Today we are releasing GitLab 9.0, 18 months after releasing 8.0. We've made significant advances to GitLab during this period, shipping a version every single month on the 22nd. Let's quickly recap how far we've come since 8.0, and see those features dovetailing into today's 9.0 release. Or jump ahead to 9.0 features.

Idea to Production

In the last several releases, GitLab has transformed how development teams get from idea to production. In just a few minutes, you can deploy GitLab to a container scheduler, add CI/CD with auto deployed review apps, utilize ChatOps, and analyze your cycle time. With 9.0 you can now watch your deploys with deploy boards and monitor application performance with Prometheus. Building on our Master Plan, GitLab 9.0 truly delivers the entire DevOps toolchain, so let's see how it all fits together:

Usability and Design

In 8.0, we refreshed GitLab's look and feel, modernizing almost every UI element and significantly improving usability. (We had even updated our logo a few months prior.) Since then, we have continued to invest in design, ramping up our UX design and research team, who are dedicated to improving usability and solving major pain points, everything from small CSS tweaks, to major UX flows. In each 8.x release we have iteratively evolved the design. And with GitLab 9.0, we made huge strides in simplifying our global, group, and project navigation, a crucial enhancement as GitLab's feature set becomes increasingly powerful.

In an effort to continue improving our UX, we now have a research panel where you can help shape the future of GitLab! By joining our panel, you'll be the first to see new features and your thoughts will drive product improvements!

Join our research panel

Collaboration on Digital Work

GitLab helps you collaborate on digital work. We made many enhancements to issues, a core part of collaboration in GitLab. This includes weights (8.3), linking to merge requests (8.3), moving an issue to another project (8.6), and a powerful filter/search interface (8.16). We also released issue boards (8.11), providing a simple mechanism for issue workflow management using stages ("lists", in GitLab parlance). GitLab 9.0 continues to enhance boards further, by improving its integration with milestones.

We are excited to ship subgroups in GitLab 9.0, another huge step in furthering GitLab collaboration. This powerful new paradigm of groups within groups allows for truly team-based and team-first collaboration in even very large organizations with many different departments. We're on a mission to enable everyone to contribute. 9.0 continues to help break down silos wherever you work so that indeed everyone in your organization can contribute.

Code Review and Code Collaboration

We've continued to improve code review and code collaboration in GitLab since 8.0, including features such as merge when pipeline succeeds (8.3), code diffs (8.4, 8.5, 8.7, 8.10, 8.15), a conflict editor (8.11, 8.13), merge request versions (8.12), blocking merge until discussions resolved (8.14), toggling approvals (8.16), as well as squash and merge (8.17). Many of these and other features involve the merge request widget. So in GitLab 9.0, we are revamping its design to accommodate the many existing and upcoming features that integrate with it.

Continuous Integration

8.0 was a pivotal release as it fully integrated continuous integration (CI) into GitLab itself. Subsequently, new CI features were implemented into the API (8.4) and pipeline events were exposed through webhooks (8.11). Pipelines were also integrated into merge requests (8.11, 8.17) and commits (8.13), as well as its own visual graph (8.11). GitLab runner was improved in every release from 8.10 to 8.17. We released review apps (8.12, 8.13, 8.14) and auto deploy (8.15) to automatically deploy code into automatically created environments. And now with GitLab 9.0, we are shipping deploy boards, allowing you track how your app is being deployed to multiple servers.

Feedback and Insight

GitLab also provides you feedback and insight into your code and development process. We released contribution analytics (8.3) and cycle analytics (8.12, 8.13, 8.14). We released time tracking (8.14, 8.16). In 8.16 and 8.17, we shipped open source Prometheus to extend that feedback into monitoring the server that hosts your GitLab instance, through the Prometheus console. In GitLab 9.0, we are releasing environment monitoring integrated into the GitLab UI itself, building on top of the Prometheus foundation.

Thank You

We're humbled by our community continuing to actively create and comment in numerous issues, as well as directly contributing source code. In 9.0, there are over 130 merge requests from the community, with many notable contributions.

As an open source project, GitLab CE now has over 47,000 commits (more than doubling the 20,000 count set back in 8.1). Today, GitLab has over 1,500 contributors. Thank you! πŸ‘πŸ™


We've also grown quickly during this time. We had just under 25 team members in 7 countries when we shipped 8.0. Today, we have over 150 folks spread across 37 countries. That has helped us now to ship self-managed GitLab in three versions, Community Edition (CE), Enterprise Edition Starter (EES), and Enterprise Edition Premium (EEP).

Unique Platform

Over the past years we’ve seen application lifecycle management (ALM) tools move into the direction of offering a single, integrated experience. GitLab is at the forefront of this and we're now shipping with monitoring by default, completing our scope. If you want to design, code, build, deploy, and monitor an application, you can now all do that straight from within GitLab.

GitLab is a complete and opinionated application lifecycle management tool with one interface and one data-store. GitLab’s integrated approach brings emergent benefits such as shorter time to market (measurable through cycle analytics), higher developer efficiency, and a consistent development process.

Enjoy 9.0 and read on for details!

Watch our release webcast!

GitLab 9.0 Meetups

Let's get together and talk about all the awesomeness coming with GitLab 9.0. We'll be in San Francisco, Denver, Boston, Amsterdam, London, and New Orleans. πŸ™Œ

Join GitLab Meetups


This month's Most Valuable Person (MVP) is Jacopo Beschi

Jacopo made it possible to undo marking a todo item as done in the todos list. This is a huge productivity enhancement that helps you recover from mistakes in managing todos. Thanks Jacopo!

Subgroups ce ees eep

GitLab has always been the simplest way for people to collaborate on code in a project. Just create a project, and you're on your way from idea to production. Users have also told us that they want GitLab to be a team-based collaboration tool that supports hierarchical team structures sharing different code repositories. With 9.0, we are excited to ship our brand new version of GitLab groups that allows for groups within groups, i.e. "subgroups".

Each group, at each level, is itself a first-class citizen GitLab group, with the ability to have multiple projects. The new version of groups thus enables you to have a hierarchy of code repositories. You can create up to 20 levels of subgroups, giving you an incredible level of flexibility.

In this example, the organization represented by the gitlab-nested group has a design team, a backend team, and a frontend team, each represented by a group within the gitlab-nested group. The design and backend groups have further subgroups within them.


Feel free to look at and provide feedback on what we are working on for groups in future releases of GitLab.

Learn more about subgroups in our docs

Deploy Boards eep

GitLab has an incredibly powerful CI/CD system, with over a thousand runners executing pipelines for projects alone. These pipelines perform builds to compile and package software, run automated tests, spawn review apps, and can even deploy software to staging and production. To date, these deployments would report back whether the environment was successfully updated, but what if you wanted more fidelity? Or a single pane to view all deployments across all environments? For larger organizations, the answers to these questions become particularly important.

Today with 9.0, we are excited to release Deploy Boards for environments running on Kubernetes. The Environments page of Pipelines now offers a single place to view the current health and deployment status of each environment, displaying the specific status of each pod in the deployment. Developers and other teammates can view the progress and status of a rollout, pod by pod, in the workflow they already use without any need to access Kubernetes.

To celebrate the launch, Deploy Boards will be available in 9.0 as a free trial for Enterprise Edition Starter customers.

Learn more about Deploy Boards in our docs

Deploy Boards

Export Issues ees eep

GitLab already enables you to filter, search, and navigate through the many issues you use daily. But users say they want a snapshot of issues for offline analysis or to communicate with other teams who may not be in GitLab just yet. With 9.0 EES, GitLab will email you a CSV export of issues if you click the download button at the top right in the issue list view.

We designed and integrated the feature directly into the project issue list view. This allows you to leverage the existing powerful filter and search capability so that you can export exactly just the issues you care about. The actual processing and email sending happens asynchronously in the background once you confirm the action, so that it gets out of your way and you can continue to use GitLab as normal.

Learn more about exporting issues in CSV in our docs

Export Issues

Environment Monitoring ce ees eep

A robust monitoring infrastructure is crucial to operating a successful application. It ensures your app is responsive, provides valuable insight into the impact of changes, and enables quick debugging when problems occur. However setting this infrastructure up is often a lower priority, in particular for non-production environments, and it is often not integrated with the rest of your toolchain.

With GitLab 9.0, we are proud to introduce the first monitoring system that is fully integrated with your CI/CD pipelines and source code repository. Leveraging Prometheus, GitLab will now bring the same technology used for production systems to development environments like staging and even review apps.

In this initial release we are tracking the CPU and Memory utilization of your app running on each Kubernetes based environment, and this is only the beginning. In the near feature we will gauge the performance impact of a merge, support a much broader range of application metrics, and fuse monitoring data with Deploy Boards.

Participate in the discussion and future of performance monitoring with GitLab here.

Learn more about the Prometheus project integration in our docs

Environment monitoring with Prometheus

Performance Improvements ce ees eep

As with every release, we've worked hard to make GitLab faster. With 9.0 in particular, we've put a particular focus on noticeable performance improvements across the board. Elasticsearch (ES) gets an upgrade in GitLab EE 9.0, with support for ES 5.1 and a host of smaller fixes. In accordance with our "cloud native" philosophy, we've added support for AWS-hosted and HTTPS Elasticsearch clusters. Larger GitLab EE installations will benefit from improvements in the initial indexing process, and minor performance improvements have been made to repository indexing.

The improvements to the dashboards were focused on more efficient searching by author or assignee, and removing unnecessary queries. As the most common use for the dashboard is to view issues or merge requests assigned to you, this should be noticeable for most users. On, we saw transaction timings drop significantly for issues and merge requests.

Take a look at the full list of performance improvements in 9.0 and keep an eye out for further improvements in upcoming releases as GitLab continues to get faster, especially for large installations.

Did you know, is "merely" a massive-scale implementation of GitLab EE with hundreds of thousands of users? This just shows the level of scale that you can run GitLab EE and these performance improvements should start making a noticeable difference to the speed and reliability of

Issues dashboardTransaction timings dropping significantly for issues dashboard

Merge requests dashboardTransaction timings dropping significantly for merge requests dashboard

Database Load Balancing ees eep

Load balancing of database queries allows one to spread the load and impact of queries across multiple database servers. Traditionally this involves additional software such as pgpool. Starting with 9.0, GitLab Enterprise Edition supports load balancing of queries when using PostgreSQL.

Load balancing queries can bring many benefits, such as reducing the load and memory usage of the primary, and reducing response timings. Spreading the load also means that badly behaving database queries will not impact queries executing on a different database server, reducing the likelihood of such queries negatively affecting a GitLab installation.

GitLab's load balancer also responds to database failovers. When a primary is unresponsive or was changed to a secondary, the load balancer will wait a brief moment before retrying an operation. When secondaries become unavailable, they are ignored until they become available again. For this to work in the most transparent way you will need to use a load balancer (e.g. HAProxy) for every database host.

One problem of load balancing is dealing with replication lag. For example, if a write happens and you then read from a secondary it's possible for said secondary to not yet have the data. One way of dealing with this is to use synchronous replication. However, synchronous replication is not ideal as replication lag could cause queries to take a very long time. Furthermore, if a replica were to become unavailable the whole system can grind to a halt.

To work around this the database load balancer uses "sticky sessions". When a user triggers a write to the primary the user's session will keep using the primary. Session sticking is disabled again once a timeout expires (30 seconds), or when the written data is available on all secondaries.

For more information on how to set up database load balancing you can refer to the documentation section "Database Load Balancing".

Load Balancing Load

Load Balancing Memory Usage

Load Balancing Timing Improvements

Updated Navigation ce ees eep

Here at GitLab, most of our business functions (not just product development) occur on itself. So we definitely understand the importance of navigation. We want to make it frictionless, intuitive, and efficient for you to perform your daily tasks, especially if you are using GitLab for several hours each day.

Navigation design is a crucial component in achieving that, and with 9.0, we have modernized the interface, leveraging best practices from our design team, as well as incorporating feedback from user research. At first glance, it doesn't seem like a lot has changed. But that was intentional. We meticulously analyzed what was already working well, and changed only the problem areas.

The menu items in the tabbed navigation interface have been re-arranged (and in some cases, merged and renamed) for both the main and subtabs. The activity tab is now a subtab of the project tab. The main tabs of repository, issues, merge requests, and pipelines and now positioned from left to right in that order, reflecting the idea to production flow. The subtabs in the main graph tab have been re-arranged and placed in other locations. Again, we carefully considered where each menu should be located drawing from feedback and analysis. Read more about the details of the change.

Another notable change is the pop-in sidebar. That has been now replaced by a less intrusive dropdown menu in the top left, that doesn't unnecessarily cover too much screen content. Previously there was a dropdown menu for settings, accessed from a cog icon at the top right for the project and group pages. These have been now pulled into the existing tabbed menu interface, harmonizing and simplifying the entire experience.

In 9.0, we simplified the project view configuration settings so that you can now choose between viewing (1) Files and README or (2) Activity on the main project tab for any project. (This is a profile setting that applies to all projects you view.) The first option is the default. Previously, we had a third option for viewing just the README, which was the default. We wanted something that was helpful for both new and existing users, and based on user feedback and research, we are opting for this design.

We also brought back the ability the create a new project quickly, by simply clicking the + button at the top right.


Reorder Issues in Board List ce ees eep

Issue Boards are a great way to manage issues moving through the different stages ("lists" in GitLab), in order to quickly get an idea to production. But users often want to further represent order or priority of issues within a single list. With 9.0, you can now reorder issues within an issue board list, using the intuitive and existing drag and drop mechanism.

Learn more about Issue Boards for Community Edition in our docs.

Boards Reorder

Boards with Milestones ees eep

A GitLab Issue Board enables you to manage a group of issues within a single milestone, but requires you to select the associated milestone filter each time you navigate to it. With GitLab 9.0 EES, you can now create an Issue Board that is associated to a specific milestone. This allows you to create unique boards for individual milestones.

As you plan and execute work in each new milestone, we suggest you keep creating new boards. This allows you to conveniently straddle between milestones, while also allowing you to save and look back at previous completed milestones.

Learn more about Issue Boards for Enterprise Edition in our docs.

Boards Milestone

API v4 ce ees eep

Our API is a great way to automate tasks, control and automate GitLab in new and powerful ways. Over time, we have continued to improve our API to make it more complete and support the new features we add every month to make GitLab the best end-to-end development environment.

This constant iteration has resulted in a few inconsistencies in our existing API. Today we are announcing v4 of our API, which aims to make the API more consistent and more RESTful.

We will continue to support v3 of the API until August 2017 and so we encourage you to make any necessary changes to applications that use the v3 API.

Take a look at the changes in v4 to see what's different.

Disaster Recovery Alpha eep

Regardless of the size of your company, you need to make sure that your infrastructure is resilient to any kind of natural or human-induced disasters that can happen. One of the best practices in this case is to have a least two servers (one primary, one secondary) in two different locations to make sure that if the primary server goes down, the other one can take over. Having this in place is critical for any teams to make sure you reduce the downtime as much as possible, and reduce the risk of data loss. We have received many requests to offer a disaster recovery solution built in GitLab and today we are introducing a first step towards supporting this.

Since GitLab 8.5, GitLab ships with Geo, a feature that lets you have one or more secondary instances that mirror your main GitLab instance. Geo's primary goal was to drastically speed up cloning and fetching projects over large distances. While Geo works really well for this use case, it has one point that prevents us to use this technology to support a full disaster recovery scenario: files that are saved on disk were not replicated.

This is what we are actively working on and with GitLab 9.0, we are releasing a first step towards providing support for Disaster Recovery scenarios. We call it Disaster Recovery in Alpha. A bunch of important changes to Geo have been introduced with this release:

  • If you use LFS, LFS objects will automatically be replicated to the secondary nodes (Merge request).
  • All file uploads are now recorded in the database (Merge request). This will allow us to replicate those files in a future iteration.
  • There is a new process to automatically backfill repositories (Merge request).
  • You can now disable a secondary node through the UI.
  • Both GitLab Geo and Disaster Recovery are under development and not production-ready.


To enable Disaster Recovery in Alpha, refer to the documentation.

Disaster Recovery in Alpha is available to all Enterprise Edition Premium customers as part of GitLab Geo.

On a sidenote, due to PostgreSQL's upgrade happening with GitLab 9.0, GitLab Geo 8.x is not compatible with GitLab Geo 9.0 and requires a manual update. If you are an existing Geo user, please read the upgrade instructions before upgrading to GitLab 9.0.

Other Improvements in GitLab 9.0

Native Unicode Emoji πŸ”₯ ce ees eep

Unicode emojis allow for a more consistent feel with the rest of your OS and equates to you being able to add emojis faster πŸš€. We were able to get rid some of the hefty images and JSON payloads and generate the awards emoji menu immediately instead of having a loading spinner to wait for an async response. πŸ‘― ✨ πŸ‹ πŸ‘Œ

Learn more about award emojis in our docs

Native unicode emojis

GitLab CI ce ees eep

To follow conventions of naming across GitLab, and to further move away from the build term and toward job, CI variables have been renamed for the 9.0 release.

8.X name 9.0 name

The old variables continue to work, however they are deprecated and will be removed soon.

Read more about the CI variables in our documentation

Gitaly ce ees eep

In every release, GitLab becomes faster with huge performance boosts. Today's release is no different. Along with other performance improvements, GitLab now ships with Gitaly, our own open-source solution to handle git calls made by GitLab. While completely transparent, this change in how GitLab operates internally is important and will make GitLab faster. We are actively working on Gitaly, so you can expect more news about it in future releases.

Group search and filtering ce ees eep

With our new version of groups in 9.0, we anticipate you'll create much more of them. So we've made it possible to filter and search groups in the list view, and also allow you to sort by when they were created or updated.

Filter Groups

Tokenized Filter and Search in Issues and Merge Requests ce ees eep

We first introduced the new streamlined filter and search interface for issues in 8.16. With 9.0, we are tokenizing the filter attributes for even more visual clarity. Many other places in GitLab deserve this new interface. We're bringing it to merge requests in 9.0, and will roll it out to other parts of GitLab in future releases.

Merge Requests New Search Interface

Impersonation Tokens ce ees eep

Alongside the new API, we've also added Impersonation tokens. If you've ever built a bot or a piece of functionality with our API, you'll often have to retrieve a token via OAuth. This can sometimes be undesirable and cumbersome to have to go through a UI flow in order to retrieve this token. Administrators of a GitLab instance can now retrieve an impersonation token on behalf of a user to make this process a lot easier and centrally controlled. This process will also alleviate any issues caused by users inadvertently invalidating tokens in use for other applications.

Read more about impersonation tokens in our API docs

GitLab Pages artifacts cleaned after deployment ce ees eep

In order to more efficiently utilize artifact storage space, GitLab Pages artifacts are now automatically deleted after they have been deployed. If you would like to retain artifacts, an expiry duration can be set.

Comments in diffs ce ees eep

Commenting in diffs is now much easier with a purple background indicating which line we are selecting. Going through discussion in comments is also much easier now that we can collapse discussions and see note authors avatars in the sidebar of the diff.

Comments in diffs

Pipeline triggers with User permissions ce ees eep

A new Pipeline Trigger API and UI is now available, which utilize the user level permissions of their creator. This enables the token to be used not just for the current project, but also all dependent projects as well. The Build Trigger API remains functional, however it is deprecated and will be removed soon.

New default value for CI variable "cache:key" ce ees eep

Unless specifically configured, the value of cache:key is now default. This allows the cache to be shared between all pipelines and jobs within the project, increasing CI/CD efficiency and speed.

Blocking manual actions in pipelines ce ees eep

Manual actions can now be configured to block pipelines until they are completed. Pipelines blocked by manual actions have a status of manual, and can be enabled by setting allow_failure to false.

More control over HTTP Strict Transport Security ce ees eep

Now you fine tune your Strict Transport Security enforcement just by changing settings in your Omnibus GitLab config. Use HTTP Strict Transport Security to provide your installation with even better protection against MITM attacks.

Learn more about HSTS in Omnibus in our docs

New Branch for Bare Projects ce ees eep

When you click the New branch button in an issue, you may want to start creating code right away. But for a project with an empty repository, GitLab, prior to 9.0, stubbornly sends you back to the main project view when you click the button. With 9.0, when you do click the New branch in an empty repository project, GitLab automatically creates the master branch, commits a blank file to it, and creates and redirects you to a new branch based on the issue title. If your project is already configured with a deployment service (e.g. Kubernetes), GitLab takes one step further and prompts you to set up auto deploy by helping you create a .gitlab-ci.yml file.

Read more about creating new branches from issues in our docs

New Branch for Repo-less Projects in GitLab 9.0

Merge Request Widget Usability ce ees eep

The merge request plays a crucial role in code collaboration and deployment. In particular, a lot of important information and call-to-actions are located in the merge request widget. With 9.0, we are starting to improve the usability of that widget. We want to present the most relevant information and allow you to see, at a glance, the status of the code, whether it's in review, or if it's already deployed in an environment. We will continue to iterate on this new cleaner design, and continue to make the entire merge request more powerful.

Merge Request Widget

Create Mattermost Team when Creating GitLab Group ce ees eep

Sometimes chatting with your workgroup is the best way to get an idea rolling. To help you with that, GitLab integrates with Mattermost. With GitLab 9.0, setting up a Mattermost team for your GitLab group to chat and collaborate is effortless. When creating a GitLab group, select the appropriate checkbox, and GitLab will tell your Mattermost instance to create a team with the same name.

Create GitLab Group Create Mattermost Team

Paginated environments ce ees eep

Pagination was added to environments list in order to improve performance and user experience. Environments that belong to a folder are now shown in a new view.

Root Level Environments Environments inside a folder

Notable Community Contributions ce

  • Add the Username to the HTTP(S) clone URL of a Repository (!9347)
  • API: Make it possible to pass coverage value to commit status endpoint (!9214)
  • Show directory hierarchy when listing wiki pages (!8133)
  • Add a feature to create a 'directly addressed' Todo when mentioned in the beginning of a line (!7926)
  • Todos can now be undone (!8691)
  • Show 99+ for large count in todos notification bell (!9171)
  • Add the option to filter todos by Added (Marked) and Pipelines (Build failed) (!8861)
  • Add merge request count to each issue on issues list (!9252)
  • Introduce /award slash command; Allow posting of just an emoji in comment (!9382)
  • Add a button to create an issue for a failing build (!9391)
  • Add user & build links in Slack Notifications (!8641)
  • Add the ability to copy a branch name to the clipboard (!9103)
  • Brand header logo for pipeline emails (!9049)

Omnibus GitLab Package Improvements ce ees eep

PostgreSQL version upgrade

Previous GitLab releases were shipped with PostgreSQL 9.2 by default. PostgreSQL 9.2's end of life (EOL) is set to September 2017. For this reason, as well as to have the latest features and performance improvements, we need to update the PostgreSQL version that GitLab uses.

GitLab 9.0 now ships with PostgreSQL 9.6 by default. For existing installations, the omnibus-gitlab packages for GitLab 9.0 will attempt to automatically upgrade your database, using the gitlab-ctl pg-upgrade tool that is included since 8.15.

Read more about database upgrade in our docs

Ran into issues? Create an issue at the omnibus-gitlab issue tracker, and reference it in the upgrade problems meta issue.

GitLab Mattermost 3.7

Mattermost 3.7 is included in GitLab 9.0. The open source Slack-alternative's newest release offers group messaging for quick, direct chats, custom channel push notification preferences, new website link previews and much more.

This version includes security updates and upgrade is recommended.

Raspberry Pi 2 changes

Due to a fault in release process that was caused by changes in build infrastructure, packages for Raspberry Pi 2 were tagged under Debian distribution instead of Raspbian.

We've resolved this issue and also synced all latest versions of packages to Raspbian distribution.

Going forward, we will only release Raspberry Pi 2 packages under Raspbian distribution. Further more, as announced in 8.17 release post, we will provide only Jessie packages for Raspberry Pi 2.

If you did any manual changes to the apt repository as a workaround, you will need to change the distribution. You can do this by running:

sed -i 's/debian/raspbian/g' /etc/apt/sources.list.d/gitlab_raspberry-pi2.list

Monitoring GitLab with Prometheus

With the release of GitLab 9.0, Prometheus and its associated exporters are now on by default. It is now easier than ever to ensure your GitLab service is healthy and responsive, with over 100 metrics available for monitoring. If you would like to disable Prometheus and all of it's related services, simply set:

prometheus_monitoring['enable'] = false

Read more on monitoring with Prometheus docs


GitLab Runner Deprecation

Please note that GitLab Runners prior to 9.0 utilize API v3, and therefore are deprecated along with the v3 API. Runners version 9.0 and above utilize the new v4 API, requiring a minimum of GitLab 9.0.

Due: August 2017.

Git-Annex deprecation

As previously announced, support for Git-Annex has been deprecated in GitLab 9.0.

Read through the Git-Annex to Git-LFS migration guide.

Due: today.

GitLab Pages IP on

We've changed the IP address of GitLab Pages server on Your DNS A record needs update. For more info, please read the blog post "We are changing the IP of GitLab Pages on".

Due: March 31st, 2017 at 23:59h UTC.

Upgrade barometer

To upgrade to GitLab 9.0, downtime is required. Larger instances (>1000 users) should expect about 15 minutes of downtime.

The specific migrations requiring downtime or taking significant time are described below.

  • Some columns are renamed. This operation requires downtime.
  • A new column is added to users table, which does not require downtime but may take some time to complete.
  • The builds table is updated, which does not require downtime but may take some time depending on your CI usage.

GitLab 9.0 introduces a new version of our API. While existing calls to API v3 will continue to work until August 2017, we advise you to make any necessary changes to applications that use the v3 API. Read the documentation to learn more.

Because of PostgreSQL's upgrade, GitLab 9.0 introduces a breaking change to GitLab Geo. If you are an existing Geo user, please refer to the documentation before upgrading to 9.0.


We assume you are upgrading from the latest version. If not, then also consult the upgrade barometers of any intermediate versions you are skipping. If you are upgrading from a GitLab version prior to 8.0 and you have CI enabled, you have to upgrade to GitLab 8.0 first.

New configuration options have been introduced in the omnibus-gitlab packages. To check what changed compared to your /etc/gitlab/gitlab.rb configuration file, run sudo gitlab-ctl diff-config.

Please be aware that by default the Omnibus packages will stop, run migrations, and start again, no matter how β€œbig” or β€œsmall” the upgrade is. This behavior can be changed by adding a /etc/gitlab/skip-auto-migrations file.

If you're GitLab EE user, please be aware that in 9.0 release we bumped the required version of Elasticsearch from 2.4.x to 5.1.x. Please update it following the official documentation. Indexes created by Elasticsearch 2.4.x can be read by Elasticsearch 5.1.x.


Please check out the changelog to see all the named changes:


If you are setting up a new GitLab installation please see the download GitLab page.


Check out our update page.

GitLab Products

We offer four different products for you and your company:

  • GitLab Community Edition (CE): Open source, self-managed solution of GitLab. Ideal for personal projects or small teams with minimal user management and workflow control needs. Every feature available in GitLab CE, is also available on GitLab Enterprise Edition (Starter and Premium), and
  • GitLab Enterprise Edition (EE): Open core, self-managed, fully featured solution of GitLab. Available in two different subscriptions:
    • GitLab Enterprise Edition Starter (EES): Ideal for co-located teams who need additional security and workflow controls for their professional projects.
    • GitLab Enterprise Edition Premium (EEP): Ideal for distributed teams who need advanced workflow controls, premium features, High Availability, and Premium Support.
  • ** **: Free GitLab solution, which runs on top of GitLab EES, hosted by GitLab, Inc. Ideal for individuals who want to get their projects up and running quickly. Administrated by GitLab (users don't have access to admin settings).

Cover image licensed under CC0.

We want to hear from you

Enjoyed reading this blog post or have questions or feedback? Share your thoughts by creating a new topic in the GitLab community forum.

Share your feedback

Take GitLab for a spin

See what your team could do with The DevSecOps Platform.

Get free trial

Have a question? We're here to help.

Talk to an expert
Edit this page View source