TYPO3/Install Aimeos/Install and configure

From Aimeos documentation

< TYPO3‎ | Install Aimeos




  • Have you checked the Prerequisites page?
  • Are these extensions installed in Admin Tools::Extension Manager
    • scheduler
    • static_info_tables

Install the Aimeos extension

  1. Log into the TYPO3 back end
  2. Click on Admin Tools::Extension Manager in the left navigation
  3. Click the icon with the little plus sign left from the Aimeos list entry

Caution: Install the RealURL extension before the Aimeos extension to get nice looking URLs. Otherwise, RealURL doesn't rewrite the parameters even if you install RealURL afterwards!

Configure the Aimeos extension

TYPO3 <= 8: To change the extension configuration, simply click on the name (Aimeos) of the extension in the extention manager.

TYPO3 8Extension Configuration

TYPO3 >= 9: In the web module Admin Tools, click on Settings, then Configure Extensions. A new overlay will appear, where you can select aimeos to open all the configuration options.

TYPO3 9.5 Admin ToolsTYPO3 9.5 Extension

There are several options available which you can either leave checked so they are enabled or uncheck to disable them:

Add demo data 
If enabled (this is the default), a category, some products and delivery and payment options are added to the database during setting up the database. This provides all data to test most of the features of Aimeos and gives you a quick demo, where you can start exploring, how to create different categories, products and delivery/payment services.
User auto-configuration for RealURL 
If RealURL for pretty, SEO friendly URLs is installed, this option (enabled by default) automatically adds the Aimeos default rules to the RealURL configuration so you get nice product URLs for example. You can also define your own RealURL rules if you like to but then you have to disable this option.
Use APC cache 
APC is a cache for the PHP files and Aimeos uses it to additionally store its configuration and the translations. If you haven't installed the APC PHP module, this option (enabled by default) is ignored and your page render times will be much slower.
APC prefix 
APC uses shared memory to store the cache data and on a web server with multiple Aimeos shops, they would interfere with each other. To prevent this, you can configure your own string that is used to prefix all stored configuration options and translated strings. The default value is "t3:".

To store any configuration changes:
in TYPO3 <= 8 click on the "disk" symbol above the "Configure Extension Aimeos" headline;
in TYPO3 >= 9 click on the "Save 'aimeos' configuration" button below the "aimeos" configuration block.

Setup the database


The Aimeos tables have to be created in the database before you can proceed. In the Aimeos entry in the extension manager list, there's a small icon on the right which shows a green, circular arrow. Click on this icon to start the setup of the database. This will take some time, from several seconds, if your database is empty, to several minutes, if you already have a lot of products and orders in your shop.

If the database doesn't contain the required tables, they are created. The tables of an existing installation are updated and their data migrated to match the installed code base. Normally, this should be a smooth upgrade process without any problems. Did you make a backup?

<< Previous: Database setup | Next: Setup the pages >> </translate>