github.com/kubri/kubri@v0.5.1-0.20240317001612-bda2aaef967e/website/docs/installation.md (about)

     1  ---
     2  sidebar_position: 2
     3  ---
     4  
     5  # Installation
     6  
     7  Kubri offers many installation methods. Check out the available methods below.
     8  
     9  ## Package Managers
    10  
    11  ### Homebrew
    12  
    13  ```sh
    14  brew install kubri/tap/kubri
    15  ```
    16  
    17  ### APT
    18  
    19  ```sh
    20  curl -fsSL https://pkg.kubri.dev/deb/key.asc | gpg --dearmor | sudo tee /usr/share/keyrings/kubri.gpg
    21  echo 'deb [signed-by=/usr/share/keyrings/kubri.gpg] https://pkg.kubri.dev/deb/ stable main' | sudo tee /etc/apt/sources.list.d/kubri.list
    22  sudo apt update
    23  sudo apt install kubri
    24  ```
    25  
    26  ### YUM / DNF
    27  
    28  ```sh
    29  echo '[kubri]
    30  name=Kubri
    31  baseurl=https://pkg.kubri.dev/rpm/
    32  enabled=1
    33  gpgcheck=0
    34  repo_gpgcheck=1
    35  gpgkey=https://pkg.kubri.dev/rpm/repodata/repomd.xml.key' | sudo tee /etc/yum.repos.d/kubri.repo
    36  
    37  # yum
    38  sudo yum install kubri
    39  
    40  # dnf
    41  sudo dnf install kubri
    42  ```
    43  
    44  ### Zypper
    45  
    46  ```sh
    47  sudo zypper addrepo "https://pkg.kubri.dev/rpm/" kubri
    48  sudo zypper --gpg-auto-import-keys refresh
    49  sudo zypper install kubri
    50  ```
    51  
    52  ### APK
    53  
    54  ```sh
    55  curl -fsSL -o /etc/apk/keys/info@kubri.dev.rsa.pub https://pkg.kubri.dev/alpine/info@kubri.dev.rsa.pub
    56  echo 'https://pkg.kubri.dev/alpine' >> /etc/apk/repositories
    57  apk add kubri
    58  ```
    59  
    60  ## Docker
    61  
    62  Run Kubri from docker.
    63  
    64  ```sh
    65  docker run --rm -v $(pwd):/app -w /app kubri/kubri:latest kubri <command>
    66  ```
    67  
    68  If signing releases you will also need to pass in your keys.  
    69  See the following example for passing in keys via an environment variable.
    70  
    71  ```sh
    72  docker run --rm -v $(pwd):/app -w /app \
    73    -e KUBRI_PGP_KEY="$(cat /path/to/pgp.key)" \
    74    -e KUBRI_RSA_KEY="$(cat /path/to/rsa.key)" \
    75    -e KUBRI_ED25519_KEY="$(cat /path/to/ed25519.key)" \
    76    -e KUBRI_DSA_KEY="$(cat /path/to/dsa.key)" \
    77    kubri/kubri:latest kubri build
    78  ```
    79  
    80  Alternatively you can also use a volume to persist the keys.
    81  
    82  ```sh
    83  # import keys
    84  docker run --rm -v $(pwd):/app -w /app -v ~/.config/kubri -v path/to/pgp.key:/pgp.key kubri/kubri:latest kubri keys import pgp /pgp.key
    85  docker run --rm -v $(pwd):/app -w /app -v ~/.config/kubri -v path/to/rsa.key:/rsa.key kubri/kubri:latest kubri keys import rsa /rsa.key
    86  
    87  # build
    88  docker run --rm -v $(pwd):/app -v ~/.config/kubri -w /app kubri/kubri:latest kubri build
    89  ```
    90  
    91  ## Binary
    92  
    93  Download the latest binary from https://github.com/kubri/kubri/releases and copy it to a folder in
    94  your `$PATH`.
    95  
    96  ## Build From Source
    97  
    98  ```sh
    99  go install github.com/kubri/kubri@latest
   100  ```