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!
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 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 192.168.99.100
For help getting started, check out the docs at https://docs.docker.com
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 http://192.168.99.100 to see "Welcome to nginx!".
Assuming that all worked, we can move on to installing the
GitLab Docker image
sudo docker run --detach \
--hostname gitlab.example.com \
--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!