Get started with GitLab Rails development

GitLab Development Kit

Configure and manage a GitLab development environment.

Read on for installation instructions or skip to doc/howto for usage documentation.


GitLab Development Kit (GDK) provides a collection of scripts and other resources to install and manage a GitLab installation for development purposes. The source code of GitLab is spread over multiple repositories and it requires Ruby, Go, Postgres/MySQL, Redis and more to run. GDK helps you install and configure all these different components, and start/stop them when you work on GitLab.

Contributing to GitLab Development Kit

Contributions are welcome, see for more details.

Getting started

To start using GDK follow these three steps:

  1. Prepare your computer
  2. Install GDK
  3. Update your existing GDK installation
  4. Learn how to use GDK

Design goals

  • Get the user started, do not try to take care of everything
  • Run everything as your 'desktop' user on your development machine
  • GitLab Development Kit itself does not run sudo commands
  • It is OK to leave some things to the user (e.g. installing Ruby)

Differences with production

  • gitlab-workhorse does not serve static files
  • C compiler needed to run bundle install (not needed with Omnibus)
  • GitLab can rewrite its program code and configuration data (read-only with Omnibus)
  • 'Assets' (Javascript/CSS files) are generated on the fly (pre-compiled at build time with Omnibus)
  • Gems (libraries) for development and functional testing get installed and loaded
  • No unified configuration management for GitLab and gitlab-shell (handled by Omnibus)
  • No privilege separation between Ruby, Postgres and Redis
  • No easy upgrades
  • Need to download and compile new gems ('bundle install') on each upgrade
  • etc.


The GitLab Development Kit is distributed under the MIT license, see the LICENSE file.

Project Statistics

Sourcerank 5
Stars 388
Forks 383
Open issues 147
Dependencies 0
Tags 5
Last updated

Packages Referencing this Repo

CLI for GitLab Development Kit.
Latest release 0.2.5 - Updated - 388 stars

Recent Tags See all

v0.2.4 November 04, 2016
v0.2.2 August 09, 2016
v0.2.1 August 09, 2016
v0.2.0 August 09, 2016
v0.1.1 August 08, 2016

Interesting Forks See all

Get started with GitLab Rails development
Updated - 1 stars
Get started with GitLab Rails development
Updated - 1 stars
Get started with GitLab Rails development
Updated - 1 stars
Get started with GitLab Rails development
Updated - 1 stars
Get started with GitLab Rails development
Updated - 1 stars - 1 forks

Something wrong with this page? Make a suggestion

Last synced: 2019-07-02 19:13:16 UTC

Login to resync this repository