Installing Oxid eSales with Docker: A guide for Windows, Linux and macOS

Oxid eSales is an open source e-commerce solution based on PHP and MySQL. It offers many features for running online shops and is easily extensible. In this blogpost we will show how to install Oxid with Docker and how to use it on Windows, Linux and macOS.

Before we start installing Oxid with Docker, let's make sure we have Docker and docker-compose installed on our system. On Windows and macOS, we can download and install Docker from the official website. On Linux, we can install Docker via our distribution's package manager.

After we have installed Docker, we can create a directory for our oxide shop and create a file there called "docker-compose.yml". In this file we define all the containers we need for our shop. For Oxid we need at least an Apache web server and a MySQL database.

Here is an example of a docker-compose.yml file for Oxid:

version: '3'
services:
  db:
    image: mysql:5.7
    environment:
      MYSQL_ROOT_PASSWORD: password
      MYSQL_DATABASE: oxid
      MYSQL_USER: oxid
      MYSQL_PASSWORD: password
  web:
    image: httpd:2.4
    volumes:
      - ./src:/var/www/html
    depends_on:
      - db
    ports:
      - "80:80"

In this example we use MySQL version 5.7 and Apache version 2.4. We also define environment variables for the MySQL container to set the root password, the name of the database and the username and password for the user. We also bind our Oxid directory to "/var/www/html" in the Apache container and set dependencies so that the Apache container is not started until the MySQL container is started.

To install Oxid, we first need to download the Oxid installation package and copy it to the directory we specified in the docker-compose.yml file. In our example, the directory would be "./src".

After we have copied the Oxid installation package, we can start the containers with docker-compose by running the following command:

docker-compose up -d

This command will start all the containers in the docker-compose.yml file in the background. After the containers are started, we can call the Oxid installation from our web browser by calling the IP address of our Docker host on port 80.

When we call the Oxid installation, we are guided through the Oxid installation wizard. We will need to enter some information such as the shop title, the username and password for the admin user and provide the database information we defined in the docker-compose.yml file. After we have entered all the necessary information, Oxid will be installed for us and we can use our new Oxid shop.

When we don't need Oxid anymore, we can shut down the containers with the following command:

docker-compose down

That's it! We have successfully installed Oxid with Docker and can now run our own Oxid shop. We hope this blogpost has helped to understand how to install Oxid with Docker and how to use it on Windows, Linux and macOS.