Skip to content

docs: update Install section in README#794

Merged
bupd merged 4 commits into
goharbor:mainfrom
adityashekhawat1999:docs/add-install-methods
May 4, 2026
Merged

docs: update Install section in README#794
bupd merged 4 commits into
goharbor:mainfrom
adityashekhawat1999:docs/add-install-methods

Conversation

@adityashekhawat1999

@adityashekhawat1999 adityashekhawat1999 commented Apr 3, 2026

Copy link
Copy Markdown
Contributor

Description

This PR improves the installation documentation by adding a dedicated INSTALL.md file and expanding the available installation methods.

Type of Change

  • Bug fix
  • New feature
  • Refactor
  • Documentation update
  • Chore / maintenance

Changes

  • Added INSTALL.md with detailed installation instructions
  • Included package based installation methods(deb, rpm, apk, apt)
  • Added a security section mentioning SBOM and Cosign support

@adityashekhawat1999

Copy link
Copy Markdown
Contributor Author

@NucleoFusion I wasn't sure about the security section can you check it and see if any more changes are required

Comment thread INSTALL.md Outdated
Comment on lines +41 to +43
#### APT repository

APT based installation is available via the project's gh-pages branch. Refer to the repository for more details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You need to add this
Refer to the .dagger/apt.go file for how.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No I meant explain the actual installation for apt
Which you can go see how in the .dagger/apt.go
I am not exactly sure for the command itself but you can ask AI or something.

It will go like, adding harbor-cli repo or something to trusted. And then apt install harbor-cli

Comment thread README.md Outdated
Comment on lines 72 to 93
@@ -92,6 +92,8 @@ brew install harbor-cli

Otherwise, you can download the binary from the [releases page](https://github.com/goharbor/harbor-cli/releases).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would keep this in the installation.md as well, and only have the 'refer to xxx' in the readme.md

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't remove the installation through homebrew i think it is best to keep it here but i moved the container configuration in install.md

Comment thread INSTALL.md Outdated

## Security

Harbor CLI provides security features such as SBOM (Software Bill of Materials) and Cosign support for verifying artifacts. These help ensure the integrity and authenticity of distributed binaries.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I would explain more
That harbor-cli provides attested binaries and images.
Via the Cosign, Checksum.

And also provides downloadable SBOM following the Dynamo format or something for each binary

@adityashekhawat1999

Copy link
Copy Markdown
Contributor Author

@NucleoFusion Please review the changes

@NucleoFusion

Copy link
Copy Markdown
Contributor

Lets discuss in the next meet how we want to re-structure the readme for the growing installation section

Comment thread README.md Outdated
source ~/.zshrc # or restart your terminal
```

## Linux, macOS and Windows

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

brew doesnt support windows idts
So you could also remove Windows from here anyway

@NucleoFusion

Copy link
Copy Markdown
Contributor

After discussing in the meeting with other maintainers as well. The implementation should show only the main install parts in the README which are:-

  • Image Install
  • Brew

And the rest of the install methods in the INSTALL.md

@adityashekhawat1999 adityashekhawat1999 force-pushed the docs/add-install-methods branch from ba94602 to 423af49 Compare April 9, 2026 05:10
@adityashekhawat1999

Copy link
Copy Markdown
Contributor Author

@NucleoFusion I have done all the changes and kept only brew and image install in readme, updated the security and apt installaton part too. Please review

Comment thread INSTALL.md Outdated
Comment on lines +41 to +43
#### APT repository

APT based installation is available via the project's gh-pages branch. Refer to the repository for more details.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No I meant explain the actual installation for apt
Which you can go see how in the .dagger/apt.go
I am not exactly sure for the command itself but you can ask AI or something.

It will go like, adding harbor-cli repo or something to trusted. And then apt install harbor-cli

@adityashekhawat1999

Copy link
Copy Markdown
Contributor Author

I have done the changes @NucleoFusion

Comment thread INSTALL.md Outdated
Comment on lines +62 to +76
```bash
echo "deb [trusted=yes] https://goharbor.github.io/harbor-cli/buildDirs/stable /" | sudo tee /etc/apt/sources.list.d/harbor-cli.list
```

2. Update package index:

```bash
sudo apt update
```

3. Install Harbor CLI:

```bash
sudo apt install harbor-cli
```

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesnt work rn due to some error in serving the apt.
Please hold on while we try to fix it.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@NucleoFusion Any updates on the apt issue

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes,but it's still not fully implemented, might take a week or two more

@NucleoFusion

Copy link
Copy Markdown
Contributor

Apt is done now, please refer to #790
We also need to add a subsection to apt where it would be

apt install ca-certificates
echo "deb [trusted=yes] https://harborcli.goharbor.io stable main" | sudo tee /etc/apt/sources.list.d/harbor-cli.list
sudo apt update
sudo apt install harbor-cli

For containerized enviroments

@NucleoFusion

Copy link
Copy Markdown
Contributor

Also, put the installation in the readme, we dont want a 2nd file

@bupd bupd changed the title docs: add INSTALL.md and update README docs: update Install section in README Apr 24, 2026
@NucleoFusion

Copy link
Copy Markdown
Contributor

@adityashekhawat1999 any update?

@adityashekhawat1999 adityashekhawat1999 force-pushed the docs/add-install-methods branch from 4c99570 to c6fd3b1 Compare May 2, 2026 17:37
Signed-off-by: Aditya Pratap Singh Shekhawat <adityashekhawat@Adityas-MacBook-Air.local>
@adityashekhawat1999 adityashekhawat1999 force-pushed the docs/add-install-methods branch from c6fd3b1 to 14643cd Compare May 2, 2026 17:46
@adityashekhawat1999

Copy link
Copy Markdown
Contributor Author

@NucleoFusion Please check if any more changes are required

Comment thread README.md
Comment thread README.md
Signed-off-by: Aditya Pratap Singh Shekhawat <adityashekhawat@Adityas-MacBook-Air.local>
Comment thread README.md
Comment thread README.md
Aditya Pratap Singh Shekhawat added 2 commits May 3, 2026 10:49
Signed-off-by: Aditya Pratap Singh Shekhawat <adityashekhawat@Adityas-MacBook-Air.local>
Signed-off-by: Aditya Pratap Singh Shekhawat <adityashekhawat@Adityas-MacBook-Air.local>

@bupd bupd left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

/lgtm

@bupd bupd merged commit 321c941 into goharbor:main May 4, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

enhancement: Adding up-to-date installation docs

3 participants