Installing (OSX)

We're currently trying to GitLab installed on Rich's 2008 Mac Pro, running OSX Yosemite (10.10.5). So, these notes (extracted and adapted from the Docker and GitLab documentation) are definitely a WIP!

Install Docker

First, make sure that you have a copy of Docker installed. Using a native Docker install instead of Docker Toolbox is recommended in order to use the persisted volumes. Here are the relevant documents:

Docker for Mac

Docker for Mac requires OS X El Capitan 10.11 or newer macOS release, running
on a 2010 or newer Mac, with Intel’s hardware support for MMU virtualization.

Basically, Docker for Mac (aka Native Docker) requires a fairly current system. If yours doesn't qualify, skip down to Docker Toolbox.

To be continued...

Docker Toolbox for Mac

Docker Toolbox is for older Mac and Windows systems that do not
meet the requirements of Docker for Mac and Docker for Windows.

Docker Toolbox supports older Mac and Windows systems, using a copy of Oracle VirtualBox and several Docker-specific tools (e.g., Docker Compose, Docker Engine, Docker Machine, Kitematic) However, it's not an ideal solution, so you shouldn't be running it if you have a choice:

  • It adds a level of complexity.
  • It doesn't support persisted volumes.
  • VirtualBox requires a lot of memory.

Still here? OK, let's get going.

  • Download DockerToolbox.pkg, the installer package file.
  • Run the installer, agreeing to anything it asks.
  • Start up 'Applications/Docker/Docker Quickstart Terminal'

This will start up Terminal, if need be, then open a command-line session. The first time Docker Toolbox starts up, it takes several minutes. Part of this latency has to do with creating and launching a VirtualBox VM image. Eventually, however, it says something like this:

docker is configured to use the default machine with IP
For help getting started, check out the docs at

Per Get started with Docker for Mac, kick the tires a bit:

$ docker --version
$ docker-compose --version
$ docker-machine --version
$ docker ps
$ docker run hello-world
$ docker run -d -p 80:80 --name webserver nginx
# Browse to to see "Welcome to nginx!".

Install GitLab

Assuming that all worked, we can move on to installing the GitLab Docker image:

sudo docker run --detach \
    --hostname \
    --publish 443:443 --publish 80:80 --publish 22:22 \
    --name gitlab \
    --restart always \
    --volume /srv/gitlab/config:/etc/gitlab \
    --volume /srv/gitlab/logs:/var/log/gitlab \
    --volume /srv/gitlab/data:/var/opt/gitlab \

Sadly, this complains:

docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
  Is the docker daemon running?.  See 'docker run --help'.

To be continued...

This wiki page is maintained by Rich Morin, an independent consultant specializing in software design, development, and documentation. Please feel free to email comments, inquiries, suggestions, etc!

Topic revision: r3 - 26 Apr 2017, RichMorin
This site is powered by Foswiki Copyright © by the contributing authors. All material on this wiki is the property of the contributing authors.
Foswiki version v2.1.6, Release Foswiki-2.1.6, Plugin API version 2.4
Ideas, requests, problems regarding CFCL Wiki? Send us email