github.com/alloyci/alloy-runner@v1.0.1-0.20180222164613-925503ccafd6/docs/install/linux-manually.md (about)

     1  # Install AlloyCI Runner manually on GNU/Linux
     2  
     3  If you don't want to use a [deb/rpm repository](linux-repository.md) to install
     4  AlloyCI Runner, or your GNU/Linux OS is not among the supported ones, you can
     5  install it manually.
     6  
     7  Make sure that you read the [FAQ](../faq/README.md) section which describes
     8  some of the most common problems with AlloyCI Runner.
     9  
    10  ## Install
    11  
    12  CAUTION: **Important:**
    13  With AlloyCI Runner 10, the executable was renamed to `alloy-runner`. If you
    14  want to install a version prior to AlloyCI Runner 10, [visit the old docs](old.md).
    15  
    16  1. Simply download one of the binaries for your system:
    17  
    18      ```sh
    19      # Linux x86-64
    20      sudo wget -O /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-linux-amd64
    21  
    22      # Linux x86
    23      sudo wget -O /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-linux-386
    24  
    25      # Linux arm
    26      sudo wget -O /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-linux-arm
    27      ```
    28  
    29      You can download a binary for every available version as described in
    30      [Bleeding Edge - download any other tagged release](bleeding-edge.md#download-any-other-tagged-release).
    31  
    32  1. Give it permissions to execute:
    33  
    34      ```sh
    35      sudo chmod +x /usr/local/bin/alloy-runner
    36      ```
    37  
    38  1. Optionally, if you want to use Docker, install Docker with:
    39  
    40      ```sh
    41      curl -sSL https://get.docker.com/ | sh
    42      ```
    43  
    44  1. Create a AlloyCI CI user:
    45  
    46      ```sh
    47      sudo useradd --comment 'AlloyCI Runner' --create-home alloy-runner --shell /bin/bash
    48      ```
    49  
    50  1. Install and run as service:
    51  
    52      ```sh
    53      sudo alloy-runner install --user=alloy-runner --working-directory=/home/alloy-runner
    54      sudo alloy-runner start
    55      ```
    56  
    57  1. [Register the Runner](../register/index.md)
    58  
    59  NOTE: **Note**
    60  If `alloy-runner` is installed and run as service (what is described
    61  in this page), it will run as root, but will execute jobs as user specified by
    62  the `install` command. This means that some of the job functions like cache and
    63  artifacts will need to execute `/usr/local/bin/alloy-runner` command,
    64  therefore the user under which jobs are run, needs to have access to the executable.
    65  
    66  ## Update
    67  
    68  1. Stop the service (you need elevated command prompt as before):
    69  
    70      ```sh
    71      sudo alloy-runner stop
    72      ```
    73  
    74  1. Download the binary to replace Runner's executable:
    75  
    76      ```sh
    77      sudo wget -O /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-linux-386
    78      sudo wget -O /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-linux-amd64
    79      ```
    80  
    81      You can download a binary for every available version as described in
    82      [Bleeding Edge - download any other tagged release](bleeding-edge.md#download-any-other-tagged-release).
    83  
    84  1. Give it permissions to execute:
    85  
    86      ```sh
    87      sudo chmod +x /usr/local/bin/alloy-runner
    88      ```
    89  
    90  1. Start the service:
    91  
    92      ```sh
    93      sudo alloy-runner start
    94      ```