Frequently asked questions
Short answers, each with a link to the page that has the detail. If a question is missing, contact support.
Getting started
Section titled “Getting started”What is CloudRepo?
Section titled “What is CloudRepo?”CloudRepo is a hosted artifact repository. You publish packages to it and download them from it with the tools you already use, and CloudRepo runs the servers. It hosts Maven, Python, npm and Docker repositories.
Which tools work with it?
Section titled “Which tools work with it?”Maven and Gradle read a Maven repository. pip and twine read and write a Python repository. npm
reads and writes an npm repository. docker logs in to, pushes to and pulls from a Docker
repository. Each tool’s page shows the file or command that connects it:
Maven, Python,
npm and Docker.
How do I get started?
Section titled “How do I get started?”Create your account, create a repository, then create a repository token for your build tool. The sign-up and first repository guides walk through the first two, and Repository Tokens covers the third for every client.
Is there a free trial?
Section titled “Is there a free trial?”CloudRepo offers a free trial. Its length and terms are on the pricing page, which is where they are kept current.
What does it cost?
Section titled “What does it cost?”See the pricing page. These docs carry no prices, so none of them can go out of date.
Repositories
Section titled “Repositories”What kinds of repository can I create?
Section titled “What kinds of repository can I create?”A repository holds one format (Maven, Python, npm or Docker) and has a mode. A local repository stores what you publish. A proxy repository fetches from an upstream and keeps a copy. For Maven and Docker only, a group repository is one address in front of several repositories. See Repository Management.
What is the difference between a release and a snapshot?
Section titled “What is the difference between a release and a snapshot?”In Maven, a version that ends in -SNAPSHOT is a development build that can be published over and
over. Any other version is a release, and by default CloudRepo refuses to replace one that exists.
See Maven Overwrite Protection.
What happens if I publish the same version twice?
Section titled “What happens if I publish the same version twice?”In a Maven, Python or npm repository, CloudRepo by default refuses it with 409 Conflict and leaves the
file that is already there. This is Overwrite Protection, a setting on each repository. Docker
repositories do not offer it: a tag you push again points to the new image. See
Maven Overwrite Protection,
Python Overwrite Protection and
Overwrite Protection.
Can I make a repository public?
Section titled “Can I make a repository public?”For Maven, Python and npm, yes: the Public Access card on a repository lets anyone read it without credentials. A Docker repository does not serve anonymous pulls. See Enabling Public Repository Access.
Can I delete files?
Section titled “Can I delete files?”Yes. In a Maven or Python repository that holds your own files, a file you delete is listed in the repository’s Trash, and someone with the Manage Repositories permission can restore it. The Trash tab carries its own notice about how long deleted items stay. See Trash and Recovery. For npm, see Unpublish a package.
How do proxy repositories work?
Section titled “How do proxy repositories work?”A proxy repository fetches a dependency from its upstream, such as Maven Central, the first time someone asks for it and keeps a copy in your organization. See Proxy Repositories.
Access
Section titled “Access”How do my builds authenticate?
Section titled “How do my builds authenticate?”With a repository token. You create it in the admin portal, choose the repositories it reaches and whether it can publish, and give it to your tool: the username is the email address of the account that created it, and the password is the token. See Repository Tokens.
What can a user do?
Section titled “What can a user do?”A user has either read and write access to every repository in your organization, or read only access to all of them. You can also grant a user administrator permissions one area at a time: billing, repositories, software distribution, users and webhooks. See User Management.
How do I give a customer access to download my software?
Section titled “How do I give a customer access to download my software?”Use Software Distribution: you put customers in subscriber groups, give each group read only access to the repositories you choose, and create access keys for each subscriber. Subscribers can only read the repositories you assign to them. See Software Distribution.
Does CloudRepo scan packages for vulnerabilities?
Section titled “Does CloudRepo scan packages for vulnerabilities?”No. CloudRepo does not scan the packages you store. Run a scanner such as Snyk, Trivy or Dependabot in your pipeline.
How is my data protected?
Section titled “How is my data protected?”See CloudRepo’s security page, which is where the security practices are published.
Integrations
Section titled “Integrations”Which CI/CD platforms are covered?
Section titled “Which CI/CD platforms are covered?”The CI/CD overview has a guide for GitHub Actions, GitLab CI/CD, CircleCI, Jenkins and Bitbucket Pipelines. Any other platform that can set an environment variable from a secret can use the same blocks.
Does CloudRepo support webhooks?
Section titled “Does CloudRepo support webhooks?”Yes. A webhook tells a server outside CloudRepo when a file is uploaded, downloaded or deleted in a Maven, Python or npm repository. See Webhooks, including the note that Docker repositories send no webhook events.
Where do I check CloudRepo’s status?
Section titled “Where do I check CloudRepo’s status?”My build fails with a 401, 403, 404 or 409. What do I check?
Section titled “My build fails with a 401, 403, 404 or 409. What do I check?”Start with Troubleshooting, which maps each status to its usual cause and its fix. The credential checks are on Repository Tokens.
How do I contact support?
Section titled “How do I contact support?”Email support@cloudrepo.io. Support lists what to include so the first reply can be an answer.
Can I run CloudRepo on my own servers?
Section titled “Can I run CloudRepo on my own servers?”No. CloudRepo is a hosted service that CloudRepo runs for you. It is not software you install.