Composer Installation Fails: Repository Authentication or Module Access Error

Problem

When attempting to install or upgrade WeltPixel modules using Composer, you may encounter authentication errors or repository access failures even after adding the correct repository configuration and authentication keys to your composer.json file.

Additionally, after successful installation, you may encounter PHP compatibility errors during compilation, particularly when upgrading to newer PHP versions.

Solution

Step 1: Enable Composer Access for Your Modules

Before you can install modules via Composer, you must explicitly enable Composer access for each purchased module or theme:

Log in to your WeltPixel account dashboard
Navigate to My Orders
Locate the order containing the modules you want to install
For each module or theme in that order, click the Enable Composer button
Repeat this process for all modules and themes you plan to install

Important: Composer access must be enabled individually for each product. Simply generating Composer keys is not sufficient—each module requires its own Composer access activation.

Step 2: Verify Repository Configuration

Ensure your composer.json includes the WeltPixel repository configuration:

"repositories": {
  "weltpixel": {
    "type": "composer",
    "url": "https://weltpixel.repo.packagist.com/YOUR-UNIQUE-ID/"
  }
}

Replace YOUR-UNIQUE-ID with the actual repository URL provided in your WeltPixel dashboard.

Step 3: Install or Update Modules

Run the appropriate Composer command:

composer require weltpixel/module-name

Or to update existing modules:

composer update weltpixel/* --with-dependencies

Step 4: Handle PHP Compatibility Issues

If you encounter PHP fatal errors during compilation (particularly with PHP 8.x), this typically indicates a compatibility issue between the module version and your PHP version.

Resolution:

Run a Composer update to pull the latest compatible versions:

composer update weltpixel/module-name --with-dependencies

Clear generated files:

rm -rf generated/*
rm -rf var/cache/*

Run Magento compilation:

bin/magento setup:di:compile

If the error persists after updating, ensure:

You're running a Magento version compatible with your PHP version
All WeltPixel modules are updated to their latest versions
No legacy module files remain in app/code/WeltPixel/

Step 5: Complete Magento Setup

After successful compilation, complete the upgrade:

bin/magento setup:upgrade
bin/magento setup:static-content:deploy
bin/magento cache:flush

Verification

To confirm the installation was successful:

Check that compilation completes without errors:

   bin/magento setup:di:compile

Verify modules are enabled:

   bin/magento module:status | grep WeltPixel

Check the installed module versions:

   composer show weltpixel/*

Access your Magento admin panel and verify the modules appear under Stores > Configuration > WeltPixel

If all commands execute without errors and the modules appear in your admin panel, the installation is complete.

Updated on: 16/02/2026

Was this article helpful?

Thank you!