Loading... Background job is running.

Edit on GitHub

Bitbucket Data Center / Server Integration Setup

Private Packagist Self-Hosted

This guide explains how to setup an OAuth integration for Private Packagist Self-Hosted with Bitbucket Data Center / Server integration.
If you are using our cloud product at packagist.com, use this guide.

Initial Setup

Hit the “Add Integration“ button on the admin page to get to the form below.

Add Integration

To setup a Bitbucket Data Center / Server integration with Private Packagist start by selecting "Bitbucket Data Center / Server" as the platform and enter the URL of your on-premise Bitbucket Server into the base URL field as seen in the example below.

Packagist Setup

Submit the form to see the additional information.

Packagist Form

Click on the link to setup an Application Link on Bitbucket Data Center / Server. You will need the "Client Id" and the "Public Key" shown in the form.

Bitbucket Configure Application Link

After you hit the button to create a new Application Link a configuration window may appear. If it does, verify that the url matches your Private Packagist URL and hit "Continue", otherwise skip this step.

Bitbucket Invalid Url

Now setup a "Generic Application". The only field required is the "Application Name". Submit the form to finish creating the Application Link.

Bitbucket Setup Link

Bitbucket Application Created

Click on the pen icon to the right of the application you just created to edit the Application Link and configure Incoming Authentication.

Bitbucket Incoming Auth

This is where we will need the "Client ID" and the "Public Key" that were previously generated on the Private Packagist integration form. Make sure the entire content of the "Public Key" field gets copied and the "Consumer Callback" field stays empty. Submit the form and go back to Private Packagist.

Finish the Setup

Update the Integration on Private Packagist to save everything and finish the setup.

Packagist Finalize

Configure Bitbucket Server plugins

In case the U2F & TOTP plugin by Alpha Server is installed on the Bitbucket Server then you will need to enable the OAuth whitelist otherwise Private Packagist will not be able to authenticate with the Bitbucket Server.

Bitbucket Server TFA Configuration

Start Free Trial

Login to create an organization and start your free trial!