Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/andreaskoch/dockerized-magento
A dockerized Magento Community Edition 1.9.x
https://github.com/andreaskoch/dockerized-magento
docker docker-compose magento-1
Last synced: about 13 hours ago
JSON representation
A dockerized Magento Community Edition 1.9.x
- Host: GitHub
- URL: https://github.com/andreaskoch/dockerized-magento
- Owner: andreaskoch
- License: bsd-3-clause
- Created: 2015-04-12T19:32:10.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2018-10-19T08:39:28.000Z (about 6 years ago)
- Last Synced: 2025-01-01T08:12:32.641Z (8 days ago)
- Topics: docker, docker-compose, magento-1
- Language: Shell
- Size: 2.54 MB
- Stars: 278
- Watchers: 18
- Forks: 144
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Dockerized - Magento Community Edition 1.9.x
A dockerized version of "Magento Community Edition 1.9.x"
## Requirements
If you are on Linux you should install
- [docker](http://docs.docker.com/compose/install/#install-docker) and
- [docker-compose (formerly known as fig)](http://docs.docker.com/compose/install/#install-compose)
If you are running on [Mac OS](https://docs.docker.com/engine/installation/mac/) or [Windows](https://docs.docker.com/engine/installation/windows/) you can install the [Docker Toolbox](https://docs.docker.com/engine/installation/mac/) which contains docker, docker-compose and docker-machine.
## Preparations
The web-server will be bound to your local ports 80 and 443. In order to access the shop you must add a hosts file entry for `dockerized-magento.local`.
### For Linux Users
In order to access the shop you must add the domain name "dockerized-magento.local" to your hosts file (`/etc/hosts`).
If you are using docker **natively** you can use this command:
```bash
sudo su
echo "127.0.0.1 dockerized-magento.local" >> /etc/hosts
```
### For Mac Users
If you are using [docker-machine](https://github.com/docker/machine) you need to use the IP address of your virtual machine running docker:
```bash
docker-machine ls
docker-machine ip
```
```bash
echo "192.168.99.100 dockerized-magento.local" >> /etc/hosts
```
**docker-machine performance**
For faster sync between your host system and the docker machine image I recommend that you activate NFS support for virtualbox: [github.com/adlogix/docker-machine-nfs](https://github.com/adlogix/docker-machine-nfs)
```bash
docker-machine create --driver virtualbox nfsbox
docker-machine-nfs nfsbox
```
And to fix issues with filesystem permissions you can modify your NFS exports configuration:
1. open `/etc/exports` and replace `-mapall=$uid:$gid` with `-maproot=0`
2. `sudo nfsd restart`
Thanks to [René Penner](https://github.com/renepenner/magento-docker-boilerplate) for figuring that out.
### For Windows Users
I suppose it will work on Windows, but I have not tested it. And I suspect that the performance will not be great due to the slow file-sharing protocol between the Windows hosts and the VirtualBox VM.
## Installation
1. Make sure you have docker and docker-compose on your system
2. Clone the repository
3. Start the projects using `./magento start` or `docker-compose up`
```bash
git clone https://github.com/andreaskoch/dockerized-magento.git && cd dockerized-magento
./magento start
```
During the first start of the project **docker-compose** will
1. first **build** all docker-images referenced in the [docker-compose.yml](docker-compose.yml)
2. then **start** the containers
3. and **trigger the installer** which will
- [install magento](docker-images/installer/bin/install.sh) and all modules that are referenced in the [composer.json](composer.json) using `composer` into the web folder
- download the [Magento Demo Store Sample Data](http://www.magentocommerce.com/knowledge-base/entry/installing-the-sample-data-for-magento)
- copy the files to the magento-root
- import the sample database
- and finally reindex all indices
Once the installation is finished the installer will print the URL and the credentials for the backend to the installer log:
```
...
installer_1 | phpMyAdmin: http://dockerized-magento.local:8080
installer_1 | - Username: root
installer_1 | - Password: pw
installer_1 |
installer_1 | Backend: http://dockerized-magento.local/admin
installer_1 | - Username: admin
installer_1 | - Password: password123
installer_1 |
installer_1 | Frontend: http://dockerized-magento.local/
```
[](https://s3.amazonaws.com/andreaskoch/dockerized-magento/installation/Dockerized-Magento-Installation-Linux-no-sound.mp4)
**Note**: The build process and the installation process will take a while if you start the project for the first time. After that, starting and stoping the project will be a matter of seconds.
## Usage
You can control the project using the built-in `magento`-script which is basically just a **wrapper for docker and docker-compose** that offers some **convenience features**:
```bash
./magento
```
**Available Actons**
- **start**: Starts the docker containers (and triggers the installation if magento is not yet installed)
- **stop**: Stops all docker containers
- **restart**: Restarts all docker containers and flushes the cache
- **status**: Prints the status of all docker containers
- **stats**: Displays live resource usage statistics of all containers
- **magerun**: Executes magerun in the magento root directory
- **composer**: Executes composer in the magento root directory
- **enter**: Enters the bash of a given container type (e.g. php, mysql, ...)
- **destroy**: Stops all containers and removes all data
**Note**: The `magento`-script is just a small wrapper around `docker-compose`. You can just use [docker-compose](https://docs.docker.com/compose/) directly.
## Components
### Overview
The dockerized Magento project consists of the following components:
- **[docker images](docker-images)**
1. a [PHP](docker-images/php/Dockerfile) image
2. a [Nginx](docker-images/nginx/Dockerfile) web server image
3. a [Solr](docker-images/solr/Dockerfile) search server
4. a standard [MySQL](https://hub.docker.com/_/mysql/) database server image
5. multiple instances of the standard [Redis](https://hub.docker.com/_/redis/) docker image
6. a standard [phpMyAdmin](https://hub.docker.com/r/phpmyadmin/phpmyadmin/) image that allows you to access the database on port 8080
7. and a [Installer](docker-images/installer/Dockerfile) image which contains all tools for installing the project from scratch using an [install script](docker-images/installer/bin/install.sh)
- a **[shell script](magento)** for controlling the project: [`./magento `](magento)
- a [composer-file](composer.json) for managing the **Magento modules**
- and the [docker-compose.yml](docker-compose.yml)-file which connects all components
The component-diagram should give you a general idea* how all components of the "dockerized Magento" project are connected:
[](documentation/dockerized-magento-component-diagram.svg)
`*` The diagram is just an attempt to visualize the dependencies between the different components. You can get the complete picture by studying the docker-compose file: [docker-compose.yml](docker-compose.yml)
Even though the setup might seem complex, the usage is thanks to docker really easy.
If you are interested in a **guide on how to dockerize a Magento** shop yourself you can have a look at a blog-post of mine: [Dockerizing Magento](https://andykdocs.de/development/Docker/Dockerize-Magento) on [AndyK Docs](https://andykdocs.de)
## Custom Configuration
All parameters of the Magento installation are defined via environment variables that are set in the [docker-compose.yml](docker-compose.yml) file - if you want to tailor the Magento Shop installation to your needs you can do so **by modifying the environment variables** before you start the project.
If you have started the shop before you must **repeat the installation process** in order to apply changes:
1. Modify the parameters in the `docker-compose.yml`
2. Shutdown the containers and remove all data (`./magento destroy`)
3. Start the containers again (`./magento start`)
### Changing the domain name
I set the default domain name to `dockerized-magento.local`. To change the domain name replace `dockerized-magento.local` with `your-domain.tld` in the `docker-compose.yml` file:
```yaml
installer:
environment:
DOMAIN: dockerized-magento.local
```
### Using a different SSL certificate
By default I chose a dummy certificate ([config/ssl/cert.pem](config/ssl/cert.pem)).
If you want to use a different certificate you can just override the key and cert with your own certificates.
### Adapt Magento Installation Parameters
If you want to install Magento using your own admin-user or change the password, email-adreess or name you can change the environment variable of the **installer** that begin with `ADMIN_`:
- `ADMIN_USERNAME`: The username of the admin user
- `ADMIN_FIRSTNAME`: The first name of the admin user
- `ADMIN_LASTNAME`: The last name of the admin user
- `ADMIN_PASSWORD`: The password for the admin user
- `ADMIN_EMAIL`: The email address of the admin user (**Note**: Make sure it has a valid syntax. Otherwise Magento will not install.)
- `ADMIN_FRONTNAME`: The name of the backend route (e.g. `http://dockerized-magento.local/admin`)
```yaml
installer:
build: docker-images/installer
environment:
ADMIN_USERNAME: admin
ADMIN_FIRSTNAME: Admin
ADMIN_LASTNAME: Inistrator
ADMIN_PASSWORD: password123
ADMIN_FRONTNAME: admin
ADMIN_EMAIL: [email protected]
```
### Change the MySQL Root User Password
I chose a very weak passwords for the MySQL root-user. You can change it by modifying the respective environment variables for the **mysql-container** ... and **installer** because otherwise the installation will fail:
```yaml
installer:
environment:
MYSQL_PASSWORD:
mysql:
environment:
MYSQL_ROOT_PASSWORD:
```