Skip to content

Install Geko ​

Manual ​

  1. Download latest release and unarchive it into folder of your choosing, for example into ~/.local/bin
  2. Add that folder to PATH variable in config file of your shell.

Example for zsh

in ~/.zshrc

bash
export PATH=/Users/my.user/.local/bin:$PATH

Via install.sh ​

  1. Donwload install.sh file
  2. Run chmod +x install.sh
  3. Run ./install.sh or pass exact release tag ./install.sh Geko@1.0.0

Make sure you are using zsh or manually add the path to executable into your shell config file.

bash
export PATH=/Users/my.user/.local/bin:$PATH

Continuous Integration (CI) ​

GitHub actions ​

There are several ways to install Geko on CI - using mise or manual installation.

Mise ​

Create a mise.toml file in the root of the project:

yaml
[tools]
"github:geko-tech/geko" = { version = "1.0.0", version_prefix = "Geko@" }

An example of a job that uses Geko:

yaml
name: Build

on:
  pull_request:
    branches:
      - main

permissions:
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
    - uses: jdx/mise-action@v2
    - name: Geko Version
      run: |
        geko version

Manual installation ​

Download the release archive of the required version to any suitable location. Urls to release archives and commands for unpacking will differ depending on the operating system (MacOS or Linux).

MacOS ​
yaml
name: Build

on:
  pull_request:
    branches:
      - main

permissions:
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
    - name: Install Geko
      run: |
        VERSION="1.0.0"
        URL="https://github.com/geko-tech/geko/releases/download/Geko@$VERSION/geko_macos.zip"
        curl -fsSL "$URL" -o "geko.zip"
        unzip -q "geko.zip" -d "geko"
        chmod +x "geko/geko"
    - name: Geko Version
      run: |
        ./geko/geko version
Linux ​
yaml
name: Build

on:
  pull_request:
    branches:
      - main

permissions:
  contents: read

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
    - name: Install Geko
      run: |
        VERSION="1.0.0"
        URL="https://github.com/geko-tech/geko/releases/download/Geko@$VERSION/geko_linux_x86_64.tgz"
        curl -fsSL "$URL" -o "geko.tgz"
        mkdir -p geko
        tar -xzf "geko.tgz" -C "geko"
        chmod +x "geko/geko"
    - name: Geko Version
      run: |
        ./geko/geko version