Magento's extension installation

Magento's extension installation

August 22, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento's extension installation

Installing Magento Extensions Locally

Installing extensions directly from your local codebase is a common practice during development or for testing purposes. Here’s a step-by-step guide on how to install a Magento extension manually.

Prerequisites

Before you begin, ensure that you have the following:

  • A local instance of Magento running.
  • The extension module files in your possession.

Step 1: Understanding Your Extension Structure

Most extensions follow a standard structure. Here’s an example of what a typical Magento 2 extension folder looks like:

magento/app/code/Vendor/Extension
│
├─ etc/
│   ├─ module.xml
│   └─ ...
│
├─ app/
│   └─ code/
│       └─ Vendor/
│           └─ Extension/
│               ├─ Block/
│               │   └─ ...
│               ├─ Controller/
│               │   └─ ...
│               ├─ Model/
│               │   └─ ...
│               ├─ view/
│               │   └─ frontent/
│               │       └─ template/
│               └─ etc/
│                   └─ config.xml
└──────────────

Step 2: Upload the Extension Files

Using an FTP client like FileZilla, connect to your local server and upload the extension files into the magento/app/code directory. Ensure that the folder structure matches the example above.

Step 3: Enabling the Extension

Method 1: Using Magento’s CLI

Open a terminal and navigate to your Magento root directory. Then run the following commands:

php bin/magento module:enable Vendor_Extension

Replace Vendor_Extension with the actual namespace of your extension.

Then, you need to clear the cache:

php bin/magento cache:flush

Method 2: Using Magento’s Admin Panel

  1. Log in to your Magento admin panel.
  2. Navigate to Stores > Configuration > Advanced > Advanced.
  3. In the System fieldset, find the Disable Modules section.
  4. Set Vendor_Extension to No.

Step 4: Compiling and Deploying Static Content

After enabling the extension, you need to compile your code and deploy static content:

php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy

Conclusion

Installing a Magento extension manually is straightforward once you understand the folder structure and commands. Remember that this method should be used primarily for development or testing purposes, not for live production sites.

If you’re looking to automate the installation process in a development environment, consider using tools like Docker or Composer with Magento’s Project-Configurator. They provide a more efficient way of handling multiple extensions and environments.

For more advanced topics on extension development and best practices, check out our comprehensive guides at Laravel Company.

Happy coding!

Magento 2 Extensions Themes Configuration

Our network