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:
-
Log in to your account at store.bird.eu
-
Navigate to Account → My Licenses
-
Create or edit your license
-
Add your domain(s) (e.g.,
yourdomain.com
) and validate -
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!