github.com/ssube/gitlab-ci-multi-runner@v1.2.1-0.20160607142738-b8d1285632e6/docs/install/linux-manually.md (about)

     1  ## Manual installation and configuration
     2  
     3  ### Install
     4  
     5  Simply download one of the binaries for your system:
     6  
     7  ```bash
     8  sudo wget -O /usr/local/bin/gitlab-ci-multi-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-386
     9  sudo wget -O /usr/local/bin/gitlab-ci-multi-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-amd64
    10  sudo wget -O /usr/local/bin/gitlab-ci-multi-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-arm
    11  ```
    12  
    13  Give it permissions to execute:
    14  
    15  ```bash
    16  sudo chmod +x /usr/local/bin/gitlab-ci-multi-runner
    17  ```
    18  
    19  Optionally, if you want to use Docker, install Docker with:
    20  
    21  ```bash
    22  curl -sSL https://get.docker.com/ | sh
    23  ```
    24  
    25  Create a GitLab CI user (on Linux):
    26  
    27  ```
    28  sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash
    29  ```
    30  
    31  Register the runner:
    32  
    33  ```bash
    34  sudo gitlab-ci-multi-runner register
    35  ```
    36  
    37  Install and run as service (on Linux):
    38  ```bash
    39  sudo gitlab-ci-multi-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
    40  sudo gitlab-ci-multi-runner start
    41  ```
    42  
    43  > **Notice**
    44  
    45  >Note that if gitlab-ci-multi-runner is installed and run as service (what is described in this page), 
    46  it will run as root, but will execute jobs as user specified by the `install` command. This means that some of the 
    47  job functions like cache and artifacts will need to execute `/usr/local/bin/gitlab-ci-multi-runner` command, therefore
    48  the user under which jobs are run, needs to have access to the executable.
    49  
    50  ### Update
    51  
    52  Stop the service (you need elevated command prompt as before):
    53  
    54  ```bash
    55  sudo gitlab-ci-multi-runner stop
    56  ```
    57  
    58  Download the binary to replace runner's executable:
    59  
    60  ```bash
    61  sudo wget -O /usr/local/bin/gitlab-ci-multi-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-386
    62  sudo wget -O /usr/local/bin/gitlab-ci-multi-runner https://gitlab-ci-multi-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-ci-multi-runner-linux-amd64
    63  ```
    64  
    65  Give it permissions to execute:
    66  
    67  ```bash
    68  sudo chmod +x /usr/local/bin/gitlab-ci-multi-runner
    69  ```
    70  
    71  Start the service:
    72  
    73  ```bash
    74  sudo gitlab-ci-multi-runner start
    75  ```
    76  
    77  Make sure that you read the [FAQ](../faq/README.md) section which describes
    78  some of the most common problems with GitLab Runner.