gitlab-org--gitlab-foss/docker
2014-12-02 16:18:32 +01:00
..
Dockerfile Remove vim since it is of no use to running GitLab. 2014-12-02 16:18:32 +01:00
gitlab.rb Add Dockerfile to build an Omnibus GitLab image 2014-11-27 15:48:19 +01:00
README.md Add troubleshooting section to the docker documentation. 2014-12-02 15:19:43 +01:00
troubleshooting.md Add troubleshooting section to the docker documentation. 2014-12-02 15:19:43 +01:00

What is GitLab?

GitLab offers git repository management, code reviews, issue tracking, activity feeds, wikis. It has LDAP/AD integration, handles 25,000 users on a single server but can also run on a highly available active/active cluster. A subscription gives you access to our support team and to GitLab Enterprise Edition that contains extra features aimed at larger organizations.

https://about.gitlab.com

GitLab Logo

How to use this image

I recommend creating a data volume container first, this will simplify migrations and backups:

docker run --name gitlab_data genezys/gitlab:7.5.1 /bin/true

This empty container will exist to persist as volumes the 3 directories used by GitLab, so remember not to delete it:

  • /var/opt/gitlab for application data
  • /var/log/gitlab for logs
  • /etc/gitlab for configuration

Then run GitLab:

docker run --detach --name gitlab --publish 8080:80 --publish 2222:22 --volumes-from gitlab_data genezys/gitlab:7.5.1

You can then go to http://localhost:8080/ (or most likely http://192.168.59.103:8080/ if you use boot2docker). Next time, you can just use docker start gitlab and docker stop gitlab.

How to configure GitLab

This container uses the official Omnibus GitLab distribution, so all configuration is done in the unique configuration file /etc/gitlab/gitlab.rb.

To access GitLab configuration, you can start a new container using the shared data volume container:

docker run -ti --rm --volumes-from gitlab_data ubuntu vi /etc/gitlab/gitlab.rb

Note that GitLab will reconfigure itself at each container start. You will need to restart the container to reconfigure your GitLab.

You can find all available options in GitLab documentation.

Troubleshooting

Please see the troubleshooting file in this directory.