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
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
-e MS_DB_USER=...(defaults to "root")
-e MS_DB_PASSWORD=...(defaults to the value of the
MYSQL_ROOT_PASSWORDenvironment variable from the linked
-e MS_DB_NAME=...(defaults to "mothership")
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
$ docker run --name mothership -e MS_DB_HOST=10.1.2.3:3306 \ -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.
mothership: image: adamyeats/mothership links: - db:mysql ports: - 80:80 db: image: mysql:5.6 environment: MYSQL_ROOT_PASSWORD: example
docker-compose up, wait for it to initialize completely, and visit
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.
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.