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

     1  # Install AlloyCI Runner on macOS
     2  
     3  In the future there will be a brew package, but for now you have to manually
     4  download the macOS binary.
     5  
     6  ## Installation
     7  
     8  1. Download the binary for your system:
     9  
    10      ```bash
    11      sudo curl --output /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-darwin-amd64
    12      ```
    13  
    14      You can download a binary for every available version as described in
    15      [Bleeding Edge - download any other tagged release](bleeding-edge.md#download-any-other-tagged-release).
    16  
    17  1. Give it permissions to execute:
    18  
    19      ```bash
    20      sudo chmod +x /usr/local/bin/alloy-runner
    21      ```
    22  
    23  **The rest of commands execute as the user who will run the Runner.**
    24  
    25  1. [Register the Runner](../register/README.md)
    26  1. Install the Runner as service and start it:
    27  
    28      ```bash
    29      cd ~
    30      alloy-runner install
    31      alloy-runner start
    32      ```
    33  
    34  Voila! Runner is installed and will be run after a system reboot.
    35  
    36  ## Update
    37  
    38  1. Stop the service:
    39  
    40      ```bash
    41      alloy-runner stop
    42      ```
    43  
    44  1. Download the binary to replace the Runner's executable:
    45  
    46      ```bash
    47      curl -o /usr/local/bin/alloy-runner https://alloy-runner-downloads.s3.amazonaws.com/latest/binaries/alloy-runner-darwin-amd64
    48      ```
    49  
    50      You can download a binary for every available version as described in
    51      [Bleeding Edge - download any other tagged release](bleeding-edge.md#download-any-other-tagged-release).
    52  
    53  1. Give it permissions to execute:
    54  
    55      ```bash
    56      chmod +x /usr/local/bin/alloy-runner
    57      ```
    58  
    59  1. Start the service:
    60  
    61      ```bash
    62      alloy-runner start
    63      ```
    64  
    65  Make sure that you read the [FAQ](../faq/README.md) section which describes
    66  some of the most common problems with AlloyCI Runner.
    67  
    68  ## Limitations on macOS
    69  
    70  >**Note:**
    71  The service needs to be installed from the Terminal by running its GUI
    72  interface as your current user. Only then will you be able to manage the service.
    73  
    74  Currently, the only proven to work mode for macOS is running service in user-mode.
    75  
    76  Since the service will be running only when the user is logged in, you should
    77  enable auto-login on your OSX machine.
    78  
    79  The service will be launched as one of `LaunchAgents`. By using `LaunchAgents`,
    80  the builds will be able to do UI interactions, making it possible to run and
    81  test on the iOS simulator.
    82  
    83  It's worth noting that OSX also has `LaunchDaemons`, the services running
    84  completely in background. `LaunchDaemons` are run on system startup, but they
    85  don't have the same access to UI interactions as `LaunchAgents`. You can try to
    86  run the Runner's service as `LaunchDaemon`, but this mode of operation is not
    87  currently supported.
    88  
    89  You can verify that the Runner created the service configuration file after
    90  executing the `install` command, by checking the
    91  `~/Library/LaunchAgents/alloy-runner.plist` file.
    92  
    93  ## Upgrade the service file
    94  
    95  In order to upgrade the `LaunchAgent` configuration, you need to uninstall and
    96  install the service:
    97  
    98  ```bash
    99  alloy-runner uninstall
   100  alloy-runner install
   101  alloy-runner start
   102  ```