# Setting up GitLab with Docker

### Useful commands:

```
sudo docker ps
sudo docker image ls
```

* Edit container:

```
sudo docker exec -it gitlab /bin/bash
```

### Starting point
* Pre-installed Ubuntu 16.04 Desktop in Virtual Box

### Set up the repository
* Update the apt package index:

```
sudo apt-get update
```
* Install packages to allow apt to use a repository over HTTPS:

```
sudo apt-get install \
    apt-transport-https \
    ca-certificates \
    curl \
    software-properties-common
```
* Add Docker's official GPG key:

```
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
```

* Set up stable repository:

```
sudo add-apt-repository \
   "deb [arch=amd64] https://download.docker.com/linux/ubuntu \
   $(lsb_release -cs) \
   stable"
```

### Install Docker CE
* Update the apt package index:

```
sudo apt-get update
```

* Install Docker ce latest version:

```
sudo apt-get install docker-ce
```

* Verify that Docker CE is working by running hello-world image:

```
sudo docker run hello-world
```

### Install Docker Compose on Linux
* Download Docker Compose:

```
sudo curl -L https://github.com/docker/compose/releases/download/1.21.2/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
```

* Apply excecutable permissions to the binary:

```
sudo chmod +x /usr/local/bin/docker-compose
```

* Test the installation:

```
sudo docker-compose --version
```

### Install GitLab using docker-compose
* Create docker-compose.yml file:

```
sudo nano docker-compose.yml
```

* Insert to file (remember to edit extrenal_url!):

```
web:
  image: 'gitlab/gitlab-ee:latest'
  restart: always
  hostname: ''
  environment:
    GITLAB_OMNIBUS_CONFIG: |
      external_url 'http://YOUR IP HERE'
      # Add any other gitlab.rb configuration here, each on its own line
  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'
```

* To start GitLab run the following command in same folder where docker-compose.yml is:

```
sudo docker-compose up -d
```

:exclamation: You need to have included ports free for this configuration to work. Common problem: SSH is on port 22 by default.