# Frequently asked questions

> Short answers about CloudRepo repositories, repository tokens, access, trials and support, each with a link to the page that has the detail.

Short answers, each with a link to the page that has the detail. If a question is missing, [contact support](/docs/reference/support.html).

## Getting started

### 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?

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](/docs/formats/maven.html), [Python](/docs/formats/python.html), [npm](/docs/formats/npm.html) and [Docker](/docs/formats/docker.html).

### How do I get started?

Create your account, create a repository, then create a repository token for your build tool. The [sign-up](/docs/get-started/sign-up.html) and [first repository](/docs/get-started/first-repository.html) guides walk through the first two, and [Repository Tokens](/docs/authenticate/repository-tokens.html) covers the third for every client.

### Is there a free trial?

CloudRepo offers a free trial. Its length and terms are on the [pricing page](https://www.cloudrepo.io/pricing), which is where they are kept current.

### What does it cost?

See the [pricing page](https://www.cloudrepo.io/pricing). These docs carry no prices, so none of them can go out of date.

## Repositories

### 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](/docs/manage/repositories.html#creating-a-repository).

### 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](/docs/formats/maven.html#maven-overwrite-protection).

### 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](/docs/formats/maven.html#maven-overwrite-protection), [Python Overwrite Protection](/docs/formats/python.html#overwrite-protection) and [Overwrite Protection](/docs/manage/repositories.html#overwrite-protection).

### 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](/docs/manage/repositories.html#enabling-public-repository-access).

### 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](/docs/manage/repositories.html#trash-and-recovery). For npm, see [Unpublish a package](/docs/formats/npm.html#unpublish-a-package).

### 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](/docs/consume/proxy-repositories.html).

## Access

### 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](/docs/authenticate/repository-tokens.html).

### 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](/docs/manage/users.html).

### 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](/docs/manage/software-distribution.html).

### 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?

See [CloudRepo’s security page](https://www.cloudrepo.io/security), which is where the security practices are published.

## Integrations

### Which CI/CD platforms are covered?

The [CI/CD overview](/docs/integrations/cicd/overview.html) 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?

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](/docs/manage/webhooks.html), including the note that Docker repositories send no webhook events.

## Help

### Where do I check CloudRepo’s status?

At [status.cloudrepo.io](https://status.cloudrepo.io).

### My build fails with a 401, 403, 404 or 409. What do I check?

Start with [Troubleshooting](/docs/reference/troubleshooting.html), which maps each status to its usual cause and its fix. The credential checks are on [Repository Tokens](/docs/authenticate/repository-tokens.html#when-a-client-answers-401-403-or-404).

### How do I contact support?

Email <support@cloudrepo.io>. [Support](/docs/reference/support.html) lists what to include so the first reply can be an answer.

### 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.

---

The page: https://www.cloudrepo.io/docs/reference/faq.html
