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.
The preferred way to use GitLab Development Kit is to install Ruby and dependencies on your 'native' OS. We strongly recommend the native install since it is much faster than a virtualized one. Due to heavy IO operations a virtualized installation will be much slower running the app and the tests.
To do a native install:
Or if you want to use a slower virtualized installation with Vagrant (for example if you're using Windows) please see the instructions for using Vagrant with VirtualBox or Docker.
After installation learn how to use GDK
If you have an old installation update your existing GDK installation
- 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
- 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)
- 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
The GitLab Development Kit is distributed under the MIT license, see the LICENSE file.