Let's document the easy installation of Omnibus Docker with Docker Compose

I came up with easy docker-compose.yml that can be used to easily configure, install, and upgrade Docker-base GitLab installation. I think that we should document this:

web:
  image: 'gitlab/gitlab-ce:latest'
  restart: always
  hostname: 'gitlab.example.com'
  environment:
    GITLAB_OMNIBUS_CONFIG: |
      external_url 'https://gitlab.example.com'
      # Add any other gitlab.rb configurations
  ports:
    - '80:80'
    - '443:443'
    - '22:22'
  volumes:
    - '/srv/gitlab/config:/etc/gitlab'
    - '/srv/gitlab/logs:/var/log/gitlab'
    - '/srv/gitlab/data:/var/opt/gitlab'

Use:

1. Install Docker Compose.
2. Create docker-compose.yml with above content in directory.
3. Use docker-compose up -d to start GitLab
4. Use docker-compose pull and docker-compose up -d to download a new release and upgrade GitLab instance.

This still requires putting the SSL certificates in /srv/gitlab/config.

Example with GitLab running on a custom port:

web:
  image: 'gitlab/gitlab-ce:latest'
  restart: always
  hostname: 'gitlab.example.com'
  environment:
    GITLAB_OMNIBUS_CONFIG: |
      external_url 'https://gitlab.example.com:9090'
      gitlab_rails['gitlab_shell_ssh_port'] = 2224
  ports:
    - '9090:9090'
    - '2224:22'
  volumes:
    - '/srv/gitlab/config:/etc/gitlab'
    - '/srv/gitlab/logs:/var/log/gitlab'
    - '/srv/gitlab/data:/var/opt/gitlab'

@axil What do you think?

This docker-compose.yml can be used to run GitLab on https://www.tutum.co.

Yes! Excellent! Super easy, super useful :)

Reassigned to @axil

Added ~15212 label

Added containers label

Milestone changed to 8.5

@axil Will you have the time o do that for 8.5?

@axil would be awesome to have this soon

Working on this now.

mentioned in merge request !650 (merged)

@ayufan GITLAB_OMNIBUS_CONFIG doesn't work for me. The external_url is not set and I see that gitlab.rb is the default. It's as if this line is not applied https://gitlab.com/gitlab-org/omnibus-gitlab/blob/5ef9752b5835614dc94493b493f646f4a06d77cb/docker/assets/setup#L22

Status changed to closed by commit d83b2410

mentioned in commit 19705eaa

mentioned in commit 834a4104

I'm having problems with GITLAB_OMNIBUS_CONFIG

environment:
     - VIRTUAL_HOST=gitlab.weare.de.com
     - LETSENCRYPT_HOST=gitlab.weare.de.com
     - LETSENCRYPT_EMAIL=support@weare.de.com
     GITLAB_OMNIBUS_CONFIG: |
       gitlab_rails['gitlab_email_from'] = 'noreply@weare.de.com'
       gitlab_rails['gitlab_email_reply_to'] = 'noreply@weare.de.com'

this errors out, probably syntax problem, any ideas why?

@sandrodz You're mixing array syntax with hash syntax. Try:

environment:
     VIRTUAL_HOST: 'gitlab.weare.de.com'
     LETSENCRYPT_HOST: 'gitlab.weare.de.com'
     LETSENCRYPT_EMAIL: 'support@weare.de.com'
     GITLAB_OMNIBUS_CONFIG: |
       gitlab_rails['gitlab_email_from'] = 'noreply@weare.de.com'
       gitlab_rails['gitlab_email_reply_to'] = 'noreply@weare.de.com'

yes, figured that one out :) thanks!

@ayufan @axil GITLAB_OMNIBUS_CONFIG doesn't work for me too.

My docker-compose.yml is like:

gitlab:
  image: gitlab/gitlab-ce:latest
  restart: always
  hostname: gitlab.urbica.co
  container_name: gitlab
  environment:
    GITLAB_OMNIBUS_CONFIG: |
      external_url 'https://gitlab.urbica.co'
      registry_external_url 'https://gitlab.urbica.co:4567'
      nginx['listen_port'] = 80
      nginx['listen_https'] = false
      registry['enable'] = true
      gitlab_rails['gitlab_default_projects_features_container_registry'] = false
      gitlab_rails['gitlab_email_enabled'] = true
      gitlab_rails['gitlab_email_from'] = "${GITLAB_EMAIL_FROM}"
      gitlab_rails['smtp_enable'] = true
      gitlab_rails['smtp_address'] = 'smtp.gmail.com'
      gitlab_rails['smtp_port'] = 587
      gitlab_rails['smtp_user_name'] = "${GITLAB_EMAIL_FROM}"
      gitlab_rails['smtp_password'] = "${SMTP_PASSWORD}"
      gitlab_rails['smtp_domain'] = 'smtp.gmail.com'
      gitlab_rails['smtp_authentication'] = 'login'
      gitlab_rails['smtp_enable_starttls_auto'] = true
      gitlab_rails['smtp_tls'] = false
      gitlab_rails['smtp_openssl_verify_mode'] = 'peer'
  ports:
    - '9090:80'
    - '2222:22'
  volumes:
    - /srv/gitlab/config:/etc/gitlab
    - /srv/gitlab/logs:/var/log/gitlab
    - /srv/gitlab/data:/var/opt/gitlab

But gitlab.rb remains untouched. What am I doing wrong?

@StepanKuzmin

We do not overwrite gitlab.rb with these settings. They are only evaluted before.

Oh, right. Thanks!