Page Contents

Overview

Bintray is a social and cooperative platform that can interact with various other platforms and management solutions such as GitHub. Bintray can import information and data structures directly from GitHub, and make them accessible from the Bintray UI for users who have accounts in both GitHub and Bintray.

Bintray is able to perform the following tasks when importing content from GitHub:

If you are importing entities and files from GitHub, please note the following:

  • Before importing any material from your GitHub to your Bintray account, the Bintray account must be authorized in GitHub to have this access.

  • GitHub and Bintray do not always use the same terminology and/or data structure. A repository in Bintray is not the same as a repository in GitHub. When importing material, repositories in GitHub become packages in Bintray. Releases, sometimes referred to as tags in GitHub, become versions in Bintray.

  • Because repositories in GitHub become packages in Bintray, you must create a repository in Bintray for these packages, before you begin the import process.

Authorizing Bintray to Import from GitHub

Before importing any material from GitHub to your Bintray account, the Bintray account must first be authorized to do this from GitHub. The process is initiated from Bintray using the OAuth protocol, and requires you to sign in to GitHub as well. You need to have a valid account in both GitHub and Bintray.

To authorize Bintray to access your GitHub account:

  1. Access your user profile by clicking your gravatar or user name in the ribbon at the top of the screen.

  2. Click the Edit button to display the Edit Your Profile page.

  3. In the General form, click the Accounts link on the left to display the Accounts form.

  4. In the Accounts form, enter your GitHub username and click Authorize with GitHub.

    GitHub User (Edit Your Profile)
    If you are already signed into GitHub, the Authorize Bintray page is displayed, otherwise you need to sign in first using your GitHub username and password.

    GitHub: authorize Bintray

    In the Authorize Bintray page, you have the option to define what parts of your GitHub account may be accessed through Bintray, however the default parameters provide sufficient functionality for most users.

  5. Click the Authorize Application button to complete the process. GitHub closes and a confirmation message is displayed on your Bintray profile.
    You are now ready to access the material on your GitHub account through Bintray.

Once you’ve authorized Bintray to access your GitHub account, you can sign in to Bintray using the "Sign in with Github" button.

GitHub: Sign into Bintray with GitHub

Importing Repositories and Releases from GitHub

Bintray enables you to import repository information stored in your GitHub account. The import process requires that your Bintray account be authorized to access your GitHub account.

To import repositories, tags and files from GitHub:

  1. Create a repository in Bintray that will contain the material imported from GitHub.

  2. In the newly-created repository, click the Import from GitHub icon.

    Import from GitHub (Repo page)

    The Import GitHub Packages page is displayed listing all your repositories and releases in GitHub.

    Note that private repositories in GitHub are only displayed and available for importing by Bintray users with Premium Plan accounts who also have "Access private repositories" permissions in GitHub.

  3. Select the checkbox next to each repository and/or release you want to import (selecting a release automatically checks the parent repository as well; selecting a repository also automatically selects all releases in that repository, but you can still deselect individual releases).

    Import from GitHub (Repo page)

    Click Import Packages.

  4. If you want to see the imported GitHub structure, click the View Repository.