### 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](https://store.bird.eu/fr/licenses/manage/list/)

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](http://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!