Install a theme

NOTE: We are in the process of modifying the file structure and configuration for many Bitnami stacks. On account of these changes, the file paths stated in this guide may change depending on whether your Bitnami stack uses native Linux system packages (Approach A), or if it is a self-contained installation (Approach B). To identify your Bitnami installation type and what approach to follow, run the command below:

 $ test ! -f "/opt/bitnami/common/bin/openssl" && echo "Approach A: Using system packages." || echo "Approach B: Self-contained installation."

The output of the command indicates which approach (A or B) is used by the installation, and will allow you to identify the paths, configuration and commands to use in this guide. Refer to the FAQ for more information on these changes.

In order to install a custom theme for Magento you need to follow these steps:

IMPORTANT: Please note that the steps described below can be different per theme. Usually the steps are defined in the theme’s readme file.

Unzip and copy the content

  • Unzip the ZIP file in the home folder. Replace the THEME placeholder with the actual filename.

      $ unzip
  • The unzipped theme folder should have the following folder structure:

  • Copy the content of the THEME/app subfolder in the Magento app folder, and the contents of the THEME/pub subfolder in the Magento pub folder:

    • Approach A (Bitnami installations using system packages):

        sudo cp -r ~/THEME/app/* /opt/bitnami/magento/app/
        sudo cp -r ~/THEME/pub/* /opt/bitnami/magento/pub/
    • Approach B (Self-contained Bitnami installations):

        sudo cp -r ~/THEME/app/* /opt/bitnami/apps/magento/htdocs/app/
        sudo cp -r ~/THEME/pub/* /opt/bitnami/apps/magento/htdocs/pub/

Redeploy static files

  • Run the following commands to upgrade, deploy the static files and clean the cache:

      $ sudo magento-cli setup:upgrade
      $ sudo magento-cli setup:static-content:deploy -f
      $ sudo magento-cli cache:clean
  • Change the owner and group of the newly added files to daemon:

    • Approach A (Bitnami installations using system packages):

        $ sudo chown -R daemon:daemon /opt/bitnami/magento/
    • Approach B (Self-contained Bitnami installations):

        $ sudo chown -R daemon:daemon /opt/bitnami/apps/magento/htdocs/

Enable the theme

  • Log into the Magento admin panel and go to “Content” > “Design” > “Configuration”.

  • Click on “Edit” in the “Default Store View”.

    Magento Go to theme edit page

  • Select your theme in the “Applied Theme” dropdown menu and click the “Save configuration” button.

    Select theme and save configuration

  • In the Magento Web Admin panel go to “System” -> “Cache Management” and click on “Flush Magento Cache”

    Flush Magento Cache

  • Watch the following video to learn how to install a Magento theme:

Last modification December 21, 2022