Docker image for Magento 2 with Becopay gateway
This repo converts the long installation guide of Magento 2 into simple Docker image to use.
Note This docker image uses the Contributing developer profile to install Magento, so it has limitations. See more details here.
Please note: this Docker image is for development and testing only, not for production use. Setting up a Magento 2 production server requires more configurations. Please refer to official documentations.
Magento 2 installation types
Magento 2 has three different ways to install, for users, integrators and developers. This Docker image uses integrator as the default installation type, so the Web Setup Wizard can be used.
Change default port
Magneto default port is 80. if this port is reserved on your server or wants to use other port, before start the docker you must change the
web service port on
docker-composer.yml. e.g. default port
80:80 change to
[...] services: web: image: becopay/magento2 ports: - "8080:80" [...] [...]
The easiest way to start Magento 2 with MySQL is using Docker Compose. Just clone this repo and run following command in the root directory. The default
docker-compose.yml uses MySQL and phpMyAdmin.
$ docker-compose up -d
For admin username and password, please refer to the file
env. You can also update the file
env to update those configurations. Below are the default configurations.
MYSQL_HOST=db MYSQL_ROOT_PASSWORD=myrootpassword MYSQL_USER=magento MYSQL_PASSWORD=magento MYSQL_DATABASE=magento MAGENTO_LANGUAGE=en_GB MAGENTO_TIMEZONE=Pacific/Auckland MAGENTO_DEFAULT_CURRENCY=USD MAGENTO_URL=http://local.magento MAGENTO_BACKEND_FRONTNAME=admin MAGENTO_USE_SECURE=0 MAGENTO_BASE_URL_SECURE=0 MAGENTO_USE_SECURE_ADMIN=0 MAGENTO_ADMIN_FIRSTNAME=Admin MAGENTO_ADMIN_LASTNAME=MyStore MAGENTO_ADMIN_EMAILfirstname.lastname@example.org MAGENTO_ADMIN_USERNAME=admin MAGENTO_ADMIN_PASSWORD=Admin123456
For example, if you want to change the default currency, just update the variable
You can find all available options in the official setup guide. If you need more options, fork this repo and add them in
After starting the container, you'll see the setup page of Magento 2. You can use the script
install-magento to quickly install Magento 2. The installation script uses the variables in the
For install Magento you are need to know the mangento container_name. first run this command to get list of your containers
$ docker ps -a
find your container name and run replace it on this command then run them for install the mangeto
$ docker exec -it <container_name> install-magento
Magento sample data provides a storefront based on the Luma theme outfitted with products, categories, customer registration, and so on. It functions just like a Magento storefront and you can manipulate prices, inventory, and promotional pricing rules using the Magento Admin.
$ docker exec -it <container_name> install-sampledata
docker-compose.yml uses MySQL as the database and starts phpMyAdmin. The default URL for phpMyAdmin is
http://localhost:8580. Use MySQL username and password to log in.
Configure the Becopay plugin
You must have a Becopay merchant account to use this plugin. It's free and easy to sign-up for a becopay merchant account.
Configure the Becopay plugin in your Magento admin panel:
- Log in to your Magento admin panel.
- In the left navigation bar, go to
Stores > Configuration.
- In the menu, go to
Sales > Payment Methods.
- Click Required Settings and fill out the following fields:
- Enable/Disable - Select
Enableto enable Becopay Payment Gateway.
- Title - Allows you to determine what your customers will see this payment option as on the checkout page.
- Mobile - Enter the phone number you registered in the Becopay here.If you don't have Becopay merchat account register here.
- Api Base Url - Enter Becopay api base url here. If you don't have Becopay merchat account register here.
- Merchant Api Key - Enter your Becopay Api Key here. If you don't have Becopay merchat account register here.
- Order Status after payment - Status given to orders after the payment has been completed
- Payment From Applicable Countries - Payment options limited to specific countries
- Sort Order - Add Gateway list sort number
- Click on Save Config For the changes you made to be effected.
Plugin Callback URL
Where is the database?
Magento 2 cannot run with a database. This image is for Magento 2 only. It doesn't contain MySQL server. MySQL server should be started in another container and linked with Magento 2 container. It's recommended to use Docker Compose to start both containers. You can also use Kubernetes or other tools.
For development and testing in the local environment, using
localhost as Magento 2 URL has some issues. The default
env file use
http://local.magento as the value of
MAGENTO_URL. You need to edit your
hosts file to add the mapping from
localhost. You can use any domain names as long as it looks like a real domain, not
localhost doesn't work, try using
How to update Magento 2 installation configurations?
Depends on how the container is used,
- When using the GUI setup page of Magento 2, update configurations in the UI.
- When using the script, update configurations in the
- When starting Magento 2 as a standalone container, use
-eto pass environment variables.
Why getting access denied error after changing the default DB password?
If you change the default DB password in
env file and get the access denied error when installing Magento 2.
Would you like to help with this project? Great! You don't have to be a developer, either. If you've found a bug or have an idea for an improvement, please open an issue and tell us about it.
If you are a developer wanting contribute an enhancement, bug fix or other patch to this project, please fork this repository and submit a pull request detailing your changes. We review all PRs!
This open source project is released under the Apache 2.0 license which means if you would like to use this project's code in your own project you are free to do so. Speaking of, if you have used our code in a cool new project we would like to hear about it! Please send us an email.
Please refer to the LICENSE file that came with this project.