Home Account & Access Generate your composer access keys

Generate your composer access keys

Last updated on Jul 01, 2025

1. Introduction

To install Blackbird Magento modules using Composer, you must first configure access to Blackbird’s private Composer repository. Without this, Composer cannot download the required packages.


2. Add the Blackbird Repository

Run the following command in your terminal:

composer config repositories.blackbird \ '{"type": "composer", "url": "https://repo.bird.eu/"}'

This tells Composer where to find the Blackbird modules.


3. Get Your Access Keys

Since the repository is private, you’ll need a Public Key and a Private Key. Here’s how to generate them:

  1. Log in to your account at store.bird.eu

  2. Navigate to Account → My Licenses

  3. Create or edit your license

  4. Add your domain(s) (e.g., yourdomain.com) and validate

  5. Your public/private key pair will be generated


4. Authenticate Composer with Your Keys

Use the following command to add your credentials to Composer:

composer config -a \ http-basic.repo.bird.eu {USERNAME} {PASSWORD}

Replace:

  • {USERNAME} with your Public Key

  • {PASSWORD} with your Private Key

💡 Pro tip: You can find a ready-to-copy version of this command in your account panel.


5. Install the Module

Once everything is set up, you can install a Blackbird module with:

composer require blackbird/module-name

Replace module-name with the actual package name (e.g., blackbird/contentmanager).


Frequently Asked Questions (FAQ)

❓ “Could not find package…” error?

  • Double-check if the repository was added correctly

  • Make sure your access keys are valid and your domain is listed

  • Try running composer clear-cache and reinstalling

❓ How to add another domain to my license?

  • Go to Account → My Licenses on store.bird.eu

  • Add and validate the new domain

  • Update or regenerate your keys if needed


If you still have issues or questions, feel free to contact us — we're here to help!