A basic installation of Mothership ready to download
Clone or download
thomasjthomasj Merge tag '1.4.0' into develop
- Integrate cookie warning
- Footer sticks to bottom of the screen
- Resolve issue where checkout tables break in Firefox on mobile breakpoints
- Resolve issue where javascript on home page breaks if no images have been assigned to the carousel
- Do not override `product.types` service, extend it instead
- Resolve issue where menus break if there is only one page present
- Resolve issue where blog listing could break by loading page content within a `usort()` block
- Do not load unpublished or deleted product pages from product page loader
- Refactor off canvas mobile menu
- Update CMS requirement to at least 4.14.0
- Update Cog to version 4.16.0
- Update Cog User to version 2.1.0
- Update CMS to version 4.14.0
- Update Commerce to version 5.20.0
- Update Discounts to version 2.1.4
- Update E-commerce to version 3.8.0
- Update Returns to version 5.4.0
Latest commit cb65e74 May 27, 2016


Mothership: E-commerce for Humans

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.

It incorporates the full range of applications you'd expect to run an online store, with some rather nice surprises too. Here's an incomplete list of the headline functionality Mothership currently supports:

  • CMS
  • Inventory
  • Shopping cart and checkout
  • Stripe integration (with open architecture for other merchants)
  • Excellent fulfilment process with printed documents and automated emails
  • Returns
  • Multiple currencies
  • Multiple tax rates
  • Gift vouchers
  • Discount tokens
  • Reports

Coming soon!

  • Electronic Point of Sale (EPOS)
  • Xero online accounts integration
  • Campaign Monitor mailing list integration

A comprehensive Functionality Reference list is available on the Mothership Wiki.

System requirements

To set up Mothership using the installer, you must have the following:

  • PHP 5.4.0 or higher
  • MySQL 5.1.0 or higher
  • Apache
    • We cannot currently offer any guarantee that Mothership works with Nginx or other server software
  • A Unix-like operating system (i.e. OSX, Linux, etc)
    • Mothership will not work in a Windows environment at present


  • Composer
    • Composer is a PHP dependency manager which can be downloaded from the Composer website.
    • Composer is not required to install Mothership using the automatic installer, but will be required for keeping your installation up to date, or installing Mothership manually
    • It is recommended that you install Composer globally
  • Git
    • We recommend using Git for version control, and this base installation takes the assumption that you are using Git to manage and track changes to your installation


There are two ways to install Mothership:

  • Using the automatic installer
  • Manually

To install, follow the instructions below. For more help, be sure to check out our wiki, or visit our forum.

The installer

To install Mothership using the installer:

  1. Download the installer
  2. Create an empty database
  3. Run php <path to>mothership.phar in the terminal
  4. Follow the instructions and answer the questions


  1. Run composer create-project mothership-ec/mothership * <path to installation>
  2. Add your database details to config/db.yml
  3. Run bin/cog migrate:run from the installation directory in the terminal
  4. Run bin/cog asset:dump and bin/cog asset:generate from the installation directory in the terminal
  5. Run chmod -R 777 tmp public logs data from the installation directory in the terminal
  6. Run bin/cog task:run user:create_admin in your terminal to create the first admin user

Working on and contributing to this repository

To set up an environment to develop on this repository

  1. Clone the repo and install the dependencies using Composer
  2. Create a config/local directory
  3. Move all config files into this directory. Be sure not to commit any of these config files.
  4. Follow instructions from 3. onwards from the manual install guide above
  5. Be sure to follow our contribution guidelines and code of conduct