From bc3b966c5108fcebee43282c43da85559d4c72d1 Mon Sep 17 00:00:00 2001
From: benjaminch <benjamin.chastanier@gmail.com>
Date: Tue, 25 Aug 2026 10:03:27 +0200
Subject: [PATCH 1/2] docs: update README with installation instructions

---
 README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 70 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 58d6f703..bb78eeed 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,80 @@
 <p align="center">
-  <img alt="Qovery Logo" src="https://raw.githubusercontent.com/Qovery/public-resources/master/qovery%20logo%20horizontal%20without%20margin.png" />
+  <img alt="Qovery Logo" src="https://www.qovery.com/logos/qovery-logo-black.svg" />
 </p>
 
 [Qovery](https://www.qovery.com/) helps tech companies to accelerate and scale application development cycle with zero infrastructure management investment.
 
 This repository is the code source of the Qovery CLI.
 
-See our complete documentation [here](https://docs.qovery.com) to get started with Qovery.
+See the [Qovery documentation](https://docs.qovery.com) to get started with Qovery.
+
+See the [Qovery CLI documentation](https://www.qovery.com/docs/cli/overview) to get started with the CLI and explore its commands.
+
+## Installation
+
+Choose the installation method for your platform.
+
+### Linux
+
+Install the latest version on any Linux distribution:
+
+```sh
+curl -s https://get.qovery.com | bash
+```
+
+For security-sensitive environments, install from a [pinned GitHub release](https://github.com/Qovery/qovery-cli/releases) and verify the downloaded archive against that release's `checksums.txt`. The convenience script does not perform an integrity check.
+
+### macOS
+
+Install with Homebrew:
+
+```sh
+brew tap Qovery/qovery-cli
+brew install qovery-cli
+```
+
+Alternatively, use the installer script:
+
+```sh
+curl -s https://get.qovery.com | bash
+```
+
+For a pinned, checksum-verified installation, use a [GitHub release](https://github.com/Qovery/qovery-cli/releases).
+
+### Windows
+
+Install with [Scoop](https://scoop.sh/):
+
+```powershell
+scoop bucket add qovery https://github.com/Qovery/scoop-qovery-cli
+scoop install qovery-cli
+```
+
+You can also download a release archive from [GitHub Releases](https://github.com/Qovery/qovery-cli/releases) and add the extracted `qovery` executable to your `PATH`.
+
+### Arch Linux
+
+The CLI is available through the AUR:
+
+```sh
+yay qovery-cli
+```
+
+### Docker
+
+Run the CLI without installing it locally:
+
+```sh
+docker run ghcr.io/qovery/qovery-cli:latest help
+```
+
+Replace `latest` with a specific version when you need reproducible builds.
+
+### Verify the installation
+
+```sh
+qovery version
+```
 
 ## Authentication
 

From edda44ab82f122e119d3cd09d67e2599a4e2c4d7 Mon Sep 17 00:00:00 2001
From: benjaminch <benjamin.chastanier@gmail.com>
Date: Tue, 25 Aug 2026 10:26:38 +0200
Subject: [PATCH 2/2] chore: make image available on ghcr

---
 .github/workflows/release.yml | 19 +++++++++++++++++--
 README.md                     | 10 ----------
 2 files changed, 17 insertions(+), 12 deletions(-)

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index a297feb4..64f433bb 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -71,6 +71,9 @@ jobs:
   # GitHub action usage
   container:
     runs-on: ubuntu-24.04
+    permissions:
+      contents: read
+      packages: write
     steps:
       - name: Checkout
         uses: actions/checkout@v5
@@ -96,13 +99,25 @@ jobs:
         uses: aws-actions/amazon-ecr-login@v2
         with:
           registry-type: public
-      - name: Build, Tag, and push image to Amazon ECR
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Build, tag, and push images
         env:
           ECR_REGISTRY: public.ecr.aws/r3m4q3r9
           ECR_REPOSITORY: qovery-cli
+          GHCR_REGISTRY: ghcr.io
+          GHCR_REPOSITORY: qovery/qovery-cli
           IMAGE_TAG: ${{ steps.vars.outputs.tag }}
         run: |
-          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . --build-arg APP_VERSION=$IMAGE_TAG
+          docker build -t $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG . --build-arg APP_VERSION=$IMAGE_TAG --label org.opencontainers.image.source=https://github.com/Qovery/qovery-cli
           docker tag $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG $ECR_REGISTRY/$ECR_REPOSITORY:latest
+          docker tag $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG $GHCR_REGISTRY/$GHCR_REPOSITORY:$IMAGE_TAG
+          docker tag $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG $GHCR_REGISTRY/$GHCR_REPOSITORY:latest
           docker push $ECR_REGISTRY/$ECR_REPOSITORY:$IMAGE_TAG
           docker push $ECR_REGISTRY/$ECR_REPOSITORY:latest
+          docker push $GHCR_REGISTRY/$GHCR_REPOSITORY:$IMAGE_TAG
+          docker push $GHCR_REGISTRY/$GHCR_REPOSITORY:latest
diff --git a/README.md b/README.md
index bb78eeed..44d1ee3f 100644
--- a/README.md
+++ b/README.md
@@ -80,16 +80,6 @@ qovery version
 
 You can use `qovery auth` to authenticate with the CLI or use `Q_CLI_ACCESS_TOKEN` (or `QOVERY_CLI_ACCESS_TOKEN`) environment variable to set your API token.
 
-## Versions
-
-You can install the latest version of the CLI:
-
-- On Mac: with brew `brew install qovery-cli`
-- On ArchLinux: with `yay qovery-cli`
-- On Windows: with scoop `scoop install qovery-cli`
-- On Docker: at the address `public.ecr.aws/r3m4q3r9/qovery-cli`
-- From binary: <https://github.com/Qovery/qovery-cli/releases>
-
 # Update deps
 
 ```sh