docker configuration
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Docker image for OpenCart with Becopay gateway

Quick start

The easiest way to start OpenCart 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.



For example, if you want to change the default currency, just update the variable ADMIN_USERNAME, e.g. ADMIN_USERNAME=adminbeco.


After starting the container, you'll see the setup page of OpenCart. You can use the script install-wordpress to quickly install OpenCart. The installation script uses the variables in the env file.


$ docker exec -it <container_name> install-opencart


The default 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 plugin

Note : You must have a Becopay merchant account to use this plugin. It's free and easy to sign-up for a becopay merchant account.

  1. Connect to Opencart admin panel.

  2. Go to this page Extensions -> Extensions

  3. On "Choose the extension type" select "Payment" then click "Filter"

  4. On payments list find "Becopay payment Gateway" then click on green button(with plus icon) to install the plugin

  5. Click on blue button(with pen icon) to editing plugin

  6. On main configuration tab fill out the following fields:

    • Status - Select "Enable" to enable Becopay Payment Gateway.
    • Mobile Number - 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.
    • Api Key - Enter your Becopay Api Key here. If you don't have Becopay merchat account register here.
    • Sort Order - Your payment gateway ordering id.
  7. Save changes.


Where is the database?

OpenCart cannot run with a database. This image is for OpenCart only. It doesn't contain MySQL server. MySQL server should be started in another container and linked with OpenCart container. It's recommended to use Docker Compose to start both containers.

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 OpenCart.

Becopay Support:


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.