PHPackages                             mothership-ec/mothership - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. mothership-ec/mothership

AbandonedLibrary

mothership-ec/mothership
========================

Mothership: E-commerce for Humans

1.4.0(9y ago)305565[11 issues](https://github.com/mothership-ec/mothership/issues)[2 PRs](https://github.com/mothership-ec/mothership/pulls)MITCSS

Since Apr 2Pushed 9y ago9 watchersCompare

[ Source](https://github.com/mothership-ec/mothership)[ Packagist](https://packagist.org/packages/mothership-ec/mothership)[ Docs](http://mothership-ec)[ RSS](/packages/mothership-ec-mothership/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelogDependencies (7)Versions (24)Used By (0)

Mothership: E-commerce for Humans
=================================

[](#mothership-e-commerce-for-humans)

[Mothership](http://mothership.ec) 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.

[![](readme_files/dashboard.jpg)](readme_files/dashboard.jpg)

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!
------------

[](#coming-soon)

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

A comprehensive [Functionality Reference list](http://wiki.mothership.ec/Functionality_Reference) is available on the Mothership Wiki.

System requirements
-------------------

[](#system-requirements)

To set up [Mothership](http://mothership.ec) using the installer, you must have the following:

- **PHP** 5.4.0 or higher
    - **PHP intl extention** (see [](http://php.net/manual/en/intl.setup.php))
- **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

### Recommended

[](#recommended)

- **Composer**
    - Composer is a PHP dependency manager which can be downloaded from [the Composer website](https://getcomposer.org/download/).
    - Composer is not required to install Mothership using the [automatic installer](http://mothership.ec/files/downloads/mothership.phar), 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](https://git-scm.com/) for version control, and this base installation takes the assumption that you are using Git to manage and track changes to your installation

Installation
------------

[](#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](http://wiki.mothership.ec), or visit [our forum](http://forum.mothership.ec).

### The installer

[](#the-installer)

To install Mothership using the installer:

1. [Download the installer](http://mothership.ec/files/downloads/mothership.phar)
2. Create an empty database
3. Run `php mothership.phar` in the terminal
4. Follow the instructions and answer the questions

### Manually

[](#manually)

1. Run `composer create-project mothership-ec/mothership * `
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
----------------------------------------------

[](#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](http://wiki.mothership.ec/Mothership#Contributing_to_Mothership) and [code of conduct](CODE_OF_CONDUCT.md)

###  Health Score

35

—

LowBetter than 80% of packages

Maintenance13

Infrequent updates — may be unmaintained

Popularity25

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~35 days

Recently: every ~60 days

Total

13

Last Release

3644d ago

Major Versions

0.0.1 → 1.0.02015-04-08

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/4520924?v=4)[Thomas Marchant](/maintainers/thomasjthomasj)[@thomasjthomasj](https://github.com/thomasjthomasj)

---

Top Contributors

[![thomasjthomasj](https://avatars.githubusercontent.com/u/4520924?v=4)](https://github.com/thomasjthomasj "thomasjthomasj (78 commits)")[![kuiche](https://avatars.githubusercontent.com/u/5089510?v=4)](https://github.com/kuiche "kuiche (40 commits)")[![aislingbrock](https://avatars.githubusercontent.com/u/3073759?v=4)](https://github.com/aislingbrock "aislingbrock (39 commits)")

---

Tags

editingcontentcmsecommercecogmothership

### Embed Badge

![Health badge](/badges/mothership-ec-mothership/health.svg)

```
[![Health](https://phpackages.com/badges/mothership-ec-mothership/health.svg)](https://phpackages.com/packages/mothership-ec-mothership)
```

###  Alternatives

[yupe/yupe

Yupe is simple and lightweight CMF for web-development, built on top of Yii 1.x

5955.5k](/packages/yupe-yupe)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
