Preparing for installation

Some preparations are necessary for the new installation of OXID eShop 7.0.

schritt Installing Composer

As of version 6, OXID eShop is no longer installed based on packaged and downloadable installation packages but with the help of Composer. Composer is a dependency manager for PHP, a tool that takes into account the dependencies of a project’s program components while installing the files of that project in a defined directory.

You need Composer for the new installation of OXID eShop. See Server and system requirements section Composer.

Installation instructions can be found in the “Getting Started” section of the Composer website:

schritt Providing shop files

The shop files are provided by Composer. Depending on the shop edition, different commands have to be run in the shell. The shop files are stored in a subdirectory that is specified with your_project_name in the command. This is based on the directory in which the command is run in the shell.

Optional: If you need the development-related files, omit the --no-dev parameter.


For the installation of the Professional and Enterprise Edition you need additional credentials, which you have received by email at the time of purchase or when they were changed.

Community Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.0-ce

Professional Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.0-pe

Enterprise Edition

composer create-project --no-dev oxid-esales/oxideshop-project your_project_name dev-b-7.0-ee

Once Composer has finished, the new directory named with your_project_name will be available. This is the main (root) directory of the project that contains all the files needed to install OXID eShop.

schritt Configuring Apache

The next step is moving the main directory to a directory that the HTTP server can access. The Apache document root directory must point to the /source directory of the main directory.

schritt Customising file and directory permissions

The HTTP server requires read and write access to the following directories and their subdirectories at runtime:


The CLI user (Command Line Interface) additionally requires read and write access for the directory /var/.

For the web-based setup, the HTTP server must have write access to the following directory and files:


schritt Creating a database

OXID eShop requires a MySQL database to store all products, categories, customer and order data, and other information. Most web hosts offer database access through a special website, such as phpMyAdmin. If you need further assistance, contact your OXID Hosting Partner or Internet Service Provider (ISP).

You have the following options:

  • Recommended: Create a new MySQL database. You can select any name for the database, for example, oxid_eshop.

Make sure to remember the name of the database and the assigned login data for the database (username and password).

You will need this data when running the setup.

  • Alternatively: Create the database during the setup.