TYPO3/Download Aimeos

From Aimeos documentation

Other languages:
Deutsch 100% • ‎English 100%


The easiest way to install Aimeos into a fresh TYPO3 installation is by using the pre-configured Aimeos distribution.


There are only a few steps until you have a fully working demo shop:

  1. Go to the extension manager
  2. Select "Get preconfigured distribution"
  3. Click on the "Install" button of the Aimeos distribution

Sometimes, the created page tree isn't visible immediately if you then go back to the page tree view. Reloading the page tree from the server by clicking on the "Reload" symbol on the right side above the page tree should fix this.

Please be aware that the distribution creates a new root page for all shop related pages (identified by the globe left of the page name). If you already have an existing page tree, the shop page tree is not accessible out of the box until you move the shop page tree into your existing one and making it a non-root page or configuring a new (sub)domain for the shop page tree!


The Aimeos extension is available in the TER:


The easiest way to install the latest version of the extension is via the TYPO3 extension manager because it should care about installing the dependencies too:

  1. Go to the extension manager
  2. Select "Get extensions"
  3. Update the extension list
  4. Search for the "aimeos" extension
  5. Click on the button in the "Actions" column

Please check afterwards, if those extensions have been installed and activated too because TYPO3 might have missed this:

  • scheduler
  • static_info_tables

If you download the Aimeos extension from the TER and upload and install it manually, installing the extensions Aimeos is depending on may not be enforced! Furthermore, the database update isn't executed automatically so you have to start the update script manually.

Latest code

The latest code of the Aimeos TYPO3 extension is available in the Github aimeos-typo3 repository. You can get the current code by using the "git" command line tool or any git client:

  1. git clone https://github.com/aimeos/aimeos-typo3.git aimeos

You can find more information about git at our Git workflow page.

The Aimeos TYPO3 extension repository only contains the code of the TYPO3 extension itself but no extensions or libraries it depends on. They can be installed by executing the phing command which uses composer to install the missing pieces:

  1. php -r "readfile('https://getcomposer.org/installer');" | php -- --filename=composer
  2. phing update

If you don't have phing available, you can also execute the required steps by hand:

  1. php -r "readfile('https://getcomposer.org/installer');" | php -- --filename=composer
  2. git pull https://github.com/aimeos/aimeos-typo3.git
  3. COMPOSER=composer.aimeos.json composer update