Aimeos 2023.04 has been released – Upgrade your ecommerce store!

By: Skynet Technologies USA LLC
8 mins
Aimeos 2023.04

Aimeos is an efficient and a popular ecommerce framework. Unlike some other platforms, it is not a monolithic application. Rather, you can choose among myriad user frontends and customize them as per your business needs.

It is perfect for medium to large-size organizations that are looking for seamless integration into their existing systems (CMS, CRM, etc.). Moreover, Aimeos is apt for portals and marketplaces due to its several specific features for marketplaces.

A new stable version of this outstanding platform was released on April 13, 2023, which is Aimeos 2023.04. This article contains details of all new features and requirements that are associated with the Aimeos first stable release of this year.

YOU MAY ALSO LIKE: Integrate ChatGPT with Aimeos

Key technical requirements to use Aimeos 2023.04

  • PHP >= 8.1
  • Composer-runtime-api > 2.1
  • Guzzlehttp / Guzzle > 7.2
  • Laravel packages Breeze > 1.20+, Sanctum > 3.2, Tinker > 2.8, Pint > 1.0, and Sail > 1.18.
  • MySQL >= 5.7.8, MariaDB >= 10.2.2, Postgre SQL > 9.6+, SQL Server 2019+.
  • Web Server Apache, Nginx, or integrated PHP web server for testing.

If certain PHP extensions are missing, Composer will let you know about the missing dependencies.

Installation of Aimeos 2023.04

To install Aimeos 2023.04, composer 2.1+ is needed. Execute below mentioned command on the CLI for complete installation –

wget https://getcomposer.org/download/latest-stable/composer.phar -O composer

php composer create-project aimeos/aimeos-headless headless

To create the administration account, it needs to give your database parameters and mail server details with email and password. These are a few basic requirements that you will be asked to move further.

Once the installation is done, test the new Aimeos installation by using an integrated PHP web server. Use the following command to start the web server –

cd headless

php artisan serve

Whereas in the hosting environment, the virtual host document root must point to the /…/headless/public/directory and it needs to change the APP_URL setting in .end file to domain without port such as APP_URL=http://myhostingdomain.com


When the installation process is complete, testing of Aimeos JSON REST API can be done by calling the URL of VHost in the browser. Browse the below-mentioned URL, if using an integrated PHP web server,

For a long now, Aimeos has front-end JSON API, which follows the guidelines of https://jsonapi.org/. JSON API assures view and order products using mobile apps or creates JavaScript applications to access any Aimeos-based online stores without hampering its experience.

YOU MAY ALSO LIKE: Aimeos vs Bagisto


To authenticate the new installation of Aimeos 2023.04 using email and password, it needs to send a POST request -

curl -X POST ""

The API will return a response if the authentication is successful -


Use the below access token in every further request as an HTTP header -

curl -X POST "" -H "Authorization: Bearer eyJ0eXAiOiJKV..."


The Aimeos admin interface will be available at /admin in VHost. Call URL if using an integrated PHP web server.

Cloud filesystems

To use cloud storage such as AWS S3 compatible object storages, adapt the resource sections in the ./config/shop.php file and configure the filesystem:

'fs' => [
  'adapter' => 'FlyAwsS3',
  'credentials' => [
    'key' => 'your-key',
    'secret' => 'your-secret',
  'region' => 'your-region',
  'version' => 'latest|api-version',
  'bucket' => 'your-bucket-name',
  'prefix' => 'your-prefix', // optional

For Azure Blob storage use:

'fs' => [
  'adapter' => 'FlyAzure',
  'endpoint' => 'DefaultEndpointsProtocol=https;AccountName=your-account;AccountKey=your-api-key',
  'container' => 'your-container',
  'prefix' => 'your-prefix', // optional

And for Google Cloud storage:

'fs' => [
  'adapter' => 'FlyGoogleCloud',
  'keyFile' => json_decode(file_get_contents('/path/to/keyfile.json'), true), // alternative
  'keyFilePath' => '/path/to/keyfile.json', // alternative
  'projectId' => 'myProject', // alternative
  'prefix' => 'your-prefix' // optional


Aimeos is an extremely flexible and highly customizable framework, and the latest stable version 2023.04 has added more to it. Aimeos with Laravel makes an amazing combination for headless ecommerce solution.

YOU MAY ALSO LIKE: Headless CMS vs Traditional CMS

All new changes that Aimeos 2023.04 ship along!

1. Checkout Flow

  • Separate checkout confirmed routes for headless distribution.

2. Cache

  • Browsers have the liberty to cache the CSS/JS files for the admin backend.

3. Additional Packages

  • Improved docs for compatibility with Laravel Breeze 1.20+.
  • Added hint for Laravel Breeze /profile route.
  • Simplified package structure
  • And support for Laravel 10.x.

4. AI and other

  • Fixed CSP for OpenAI and DeepL
  • Improved accessibility
  • Enabled CSP in non-debug mode.

5. Headless distribution

Ecommerce headless distribution of Aimeos 2023.04 has come up with-

  • It supports Laravel 10.
  • Merged order and order base data.
  • Supports remote file import.
  • And Kubernetes/Serverless (AWS, Google, Azure) support.

6. Ecommerce core libraries

Aimeos 2023.04, which is the first stable release of 2023 has some important inclusion such as

  • It supports cloud native Yugabyte DB
  • PHPUnit 10 support

Wrapping up

Aimeos 2023.04 certainly has some useful enhancements that will help to scale ecommerce store. And this is the first stable release of the year, thus, the changes are going to remain for some time now. If you haven’t updated yet, don’t wait for more and update your ecommerce store with the latest version.

As an official international ecommerce expert partners of Aimeos, we offer comprehensive Aimeos ecommerce development services which include designing, developing, customizing, managing content, upgrading, migrating, creating multi-channel multi-vendor marketplaces, providing multi-tenant SaaS (Software as a Service) solutions, providing maintenance and support. Our team of expert Laravel developers is skilled in handling multidisciplinary and multi-technology projects of any scale. If you have any requirements, please do not hesitate to contact us. Share all your requirements by filling out the following request a quote form or sending an email to [email protected].