Public | Automated Build

Last pushed: a year ago
Short Description
:rocket: a docker image to deploy an apache-fronted instance of mothership
Full Description

Note regarding this repo

This project is now deprecated and will be deleted in 2017. As Mothership has been unmaintained for some time now, I will remove it in January 2017. Any users of this Docker image are encouraged to fork if they still need to use it as part of thier applications.


:rocket: a docker image to deploy an apache-fronted instance of mothership

What is Mothership?

Mothership is open source web retail software, combining e-commerce with Electronic Point Of Sale (EPOS) into a single, unified platform. It is based on over 10 years experience, yet it is entirely new, containing zero legacy code, making it a perfect platform for developers.

How to use this image

Start a mothership server instance

$ docker run -it --name mothership --link your-mysql-container:mysql -p 80:80 adamyeats/mothership

The following environment variables are also honored for configuring your Mothership instance:

  • -e MS_DB_HOST=... (defaults to the IP and port of the linked mysql container)
  • -e MS_DB_USER=... (defaults to "root")
  • -e MS_DB_PASSWORD=... (defaults to the value of the MYSQL_ROOT_PASSWORD environment variable from the linked mysql container)
  • -e MS_DB_NAME=... (defaults to "mothership")

If the MS_DB_NAME specified does not already exist on the given MySQL server, it will be created automatically upon startup of the mothership container, provided that the MS_DB_USER specified has the necessary permissions to create it.

If you'd like to use an external database instead of a linked mysql container, specify the hostname and port with MS_DB_HOST along with the password in MS_DB_PASSWORD and the username in MS_DB_USER (if it is something other than root):

$ docker run --name mothership -e MS_DB_HOST= \
    -e MS_DB_USER=... -e MS_DB_PASSWORD=... -p 80:80 adamyeats/mothership

Please note that there are currently issues running Mothership with anything above MySQL v5.6, so I recommend using the image for the 5.6 version.

Also, please be aware that unless you are linking a volume containing a pre-existing Mothership installation into /var/www/html, the script will try and build a new Mothership installation. This will take a long, long time on all machines, so don't be alarmed if bringing a new container up takes 5-10 minutes.

... via docker-compose

Example docker-compose.yml for mothership:

  image: adamyeats/mothership
    - db:mysql
    - 80:80

  image: mysql:5.6

Run docker-compose up, wait for it to initialize completely, and visit http://host-ip:8080.

Supported Docker versions

This image is officially supported on Docker version 1.10.2.

Support for older versions (down to 1.6) is not guaranteed.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback


If you have any problems with or questions about this image, please contact us through a GitHub issue.


You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.

Docker Pull Command
Source Repository