FAQ
- General Questions
- Repository Management
- How do I add my repository to Artifact Hub?
- How do I become a verified publisher?
- How can I claim ownership of a repository that someone else added?
- What are the benefits of claiming repository ownership?
- Where should I place the artifacthub-repo.yml file?
- I've added the metadata file but I still can't see the verified publisher status
- Can I change my repository name after creating it?
- Why am I getting "There is another repository using this url" error?
- How do I force my repository to be reprocessed?
- Helm Charts
- Can I use Artifact Hub as a single charts repository for all the charts listed on it?
- What is the source of the README file displayed in Artifact Hub?
- How do I add changelog information to my chart?
- Why aren't my chart updates appearing?
- How do I add container images for security scanning?
- Why do old chart versions disappear from Artifact Hub?
- How do I add OCI-based Helm charts?
- Can I add my entire OCI registry to Artifact Hub?
- How do I add the repository metadata file for OCI repositories?
- Authentication
- Self-hosted Deployments
- How do I install Artifact Hub on my own infrastructure?
- Can I use custom OAuth providers?
- How do I enable private repositories?
- How do I add repositories to my self-hosted instance?
- What's the demo user for self-hosted instances?
- Can I restrict access to some of the content in my self-hosted instance?
- API and integrations
- Official Status and Verification
- Security Reports
- Getting Help
Artifact Hub is a web-based application that enables finding, installing and publishing packages and configurations for CNCF projects.
Artifact Hub supports 25+ artifact kinds. Please see the repositories guide for a full list and more information about each of them.
The best way is opening an issue in the Artifact Hub GitHub repository. Please see other examples to see how the process works. Note that Artifact Hub currently only supports vendor neutral artifacts. Everything listed is currently in a foundation and not attached to a single vendor.
Repositories are processed every 30 minutes. Once your repository is processed again, changes should be visible in less than 5 minutes.
No, it's not possible to install applications from Artifact Hub. In the package detail view, we provide installation instructions that will tell you how to add the repository and install the package using the appropriate tool for the artifact kind. Note that Artifact Hub does not store or proxy the content of the repositories. It only collects some metadata from them.
You can add your repository to Artifact Hub from the control panel in the UI after signing in. Please see the repositories guide for more details about each supported repository kind.
You need to add a metadata file to the repository including the repository ID listed in the control panel. For more information please see the verified publisher section of the repositories guide.
You can claim the ownership of a repository automatically by following this process. It's an automated process that doesn't require contacting the current owners - you just need to add a metadata file with your email address.
It has some advantages:
- Users will see your organization as the publishing organization
- You can control the repository from the control panel, explore tracking errors or receive alerts for some events
- Your repository can obtain the
Verified Publisher
badge - You can request the
Official
badge as well (this one is not automated, needs to be done via a Github issue)
In the case of Helm charts repositories, the metadata file is expected to be served at the same level as your index.yaml
file. For example: https://your-domain.github.io/helm-charts/artifacthub-repo.yml
. In the case of other artifact kinds that rely on the artifacthub-pkg.yml
metadata file, the repository metadata file is expected to be located at the root of the repository packages path.
The verified publisher flag won’t be set until the next time the repository is processed. Please keep in mind that the repository won’t be processed if it hasn’t changed since the last time it was processed.
No, the repository name cannot be updated once created.
A repository can only be added once to Artifact Hub to avoid duplicates. If someone else has already added a repository that belongs to you, you can claim its ownership.
You can force your repository to be processed at any time by updating an existing package version or pushing a new one.
No, this is not possible. Artifact Hub allows you to search for charts available in multiple repositories, but it doesn't store or proxy the content in them, only some metadata.
The README displayed is the one in the chart tgz package. To update it, you can either release a new chart version or update an existing version (making sure the version digest is updated).
The changes are included as a list of entries using an annotation. Each version is expected to provide only the changes it includes, not the full change log. You can see an example in the Helm annotations documentation.
The tracker runs every 30 minutes and processes versions that haven't been indexed yet. If the digest of a version changes, that version is indexed again as we consider something must have changed on it.
When container images are not defined in the Helm chart annotations, Artifact Hub tries to detect them from the manifests generated by a dry-run install. When the detection isn't accurate, the best way to fix it is by defining the container images manually in the Chart.yaml
file using the artifacthub.io/images
annotation.
Artifact Hub relies on the repository index, so whenever it's truncated, charts not available on it are removed from Artifact Hub as well. We don't store the artifacts themselves, only some of their metadata.
For OCI-based Helm charts, you need to setup one Artifact Hub repository per chart. Please see the Helm OCI support section for more details.
Unfortunately, you need to setup one repository for each chart when using OCI-based repositories. The reason it works this way is a combination of how Helm OCI-based repositories work and that the OCI distribution specification doesn't define a mechanism to list all references for a given namespace.
The metadata file needs to be pushed to the OCI registry as well, using a special tag. You can find more details in the Helm OCI support section.
Do you have the recovery codes provided during the 2FA setup process? If yes, when you are prompted for a code from your 2FA device/app, you can use one of those recovery codes to log in. Please note that those recovery codes can only be used once each.
At the moment it's not possible to update the email address from the control panel. You can create a new account and, if you have any repositories, transfer them to it from the control panel.
You can deploy your own Artifact Hub instance using the official Helm chart. This is the recommended way of deploying your own instance.
No, there isn't support for custom OAuth providers at the moment, but you can use an OpenID Connect provider in your Artifact Hub deployments.
Private repositories are only supported in self-hosted Artifact Hub deployments, not in artifacthub.io
. You can enable it by setting hub.server.allowPrivateRepositories
to true
. Once that's done, you should see the username and password fields in the UI when adding or updating a repository.
Once you have your Artifact Hub instance up and running, you can add your repositories from the UI control panel like you would do in artifacthub.io
.
When the parameter dbMigrator.loadSampleData
is set to true (default), a demo user and a couple of sample repositories are registered automatically. The credentials for the demo user are: demo@artifacthub.io
/ changeme
. You can change the password from the control panel once you log in.
No, there is no way to restrict the visibility of the content available on Artifact Hub, even in your own instance.
The exact numbers are not documented because they are updated every now and then and vary depending on the endpoint used and the current service status. There are some integration endpoints that allow dumping a lot of content in a single request, which may be handy in some cases (e.g. Harbor replication endpoint).
You could use the Harbor replication endpoint.
Yes, you can use this endpoint. The security reports are generated using Trivy. We store the full output of Trivy (in json format).
The official status is granted manually and needs to be requested via a GitHub issue. Please see the official status section in the repositories guide for more details.
The Verified Publisher
status is automated and shows that the publisher has verified ownership of the repository. The Official
status is manually granted and indicates that the publisher owns the software a package primarily focuses on.
Yes, if the repository or package belongs to an organization or company.
Security reports are generated using Trivy. The latest package version available is scanned daily, whereas previous versions are scanned weekly. This happens even if nothing has changed in the package version. Versions released more than one year ago or with more than 15 container images won’t be scanned.
You can whitelist individual images so that they're not scanned for security vulnerabilities. Note that this is only possible when you define your images manually. You can also disable the security scanner for the entire repository from the control panel.
The most frequent cause is that we were not able to automatically detect their images. We try to detect them by applying some regular expressions in the output of a dry-run chart install, using the default values. Unfortunately, this mechanism does not always work: sometimes some of the images cannot be detected this way, and sometimes none are found. When this happens, you can provide the images manually by using the artifacthub.io/images
annotation in the Chart.yml
file.
No, Artifact Hub does not support scanning images on private registries.
For issues with the content listed on artifacthub.io
, it's best to contact the particular project directly. In the links section of the right panel in the package view, you usually may find some links that can point you to the project's repository or the maintainers' emails.
Check these resources:
You can create a discussion or issue on the Artifact Hub GitHub repository.