Page Contents

Overview

The key concepts described below are used extensively in this user manual, and it’s important for you to understand their meaning in the context of Bintray.

Bintray entities diagram

Users and Organizations

Users and organizations are the entities that use Bintray.

Users

A user represents a single person with a Bintray account. Each Bintray user has a user profile with his or her contact information and it is within this account that the user owns all other entities. A user may create repos, packages and versions and then upload files.

Organizations

An organization represents a group of users who can work cooperatively on the same modules of software. Members of the same organization may share authorizations to modify content and to upload files into the same location. A user within an organization (with the appropriate authorizations) may create repos, packages and versions and then upload files.

Repositories, Packages, and Versions

Repositories, packages, and versions represent the hierarchy in which your data is stored in Bintray as displayed in the diagram below.

Bintray data structure

Repositories

A repository is a logical unit that hosts your packages. When you create your Bintray account it automatically includes a repository for each of the package types for which Bintray offers native support, namely, Docker, Maven, Debian, RPM, Vagrant, and NuGet. The repository maintains metadata about the packages and versions it contains that allows the corresponding clients to work transparently with Bintray.

By default, your repositories are fully accessible to any Bintray user. To make a repository private, you first need to upgrade to a Premium plan. Then you can designate your repository as "Premium" and have full control over who can access your uploaded content.

Parts of the Repository page

Packages

A package is a logical entity, and the main one with which Bintray works. It consists of interdependent files grouped into versions, that functionally, must be together in order to work. You can link your packages to other repositories to increase their exposure. You can also merge several packages into one.

Parts of the package page

Versions

Versions are periodic releases of the software represented by the package, and are the Bintray entities that hold the files. "Version" always means a version of a package, and any update or change in the material uploaded and published is a new version.

Files are always uploaded into a version, so before you can upload files, you need to create the version that will contain them. Info about the files themselves (such as readme, release notes, screenshots, etc.) may also be added to the version or its parent package.

When downloading, you can manually download any published file when you access the version through the Bintray UI. The version may also contain information about the files to help you choose if this particular version contains the files you need.

Parts of the Version page