Description
===========

mmcFE-ng is a web frontend for Pooled LTC Mining.

This is based on mmcFE, the original work by Greedi:
https://github.com/Greedi/mmcFE

After working a few days trying to learn to run my own pool and the
systems behind it I figured I'd look a bit deeper in the code to
understand how it works. While doing so I also migrated the existing
code over to my own framework so maintenance would be easier in the
future.

Requirements
============

This setup has been tested on Ubuntu 12.04, Ubuntu 13.04 and CentOS.
It should also work on any related distribution (RHEL, Debian).
For support on how to get `litecoind` or `pushpoold` to work, please ask
in the appropriate forums.

* Apache2
 * libapache2-mod-php5
* PHP 5.4+ (5.3 might work too)
 * php5-mysqlnd
 * php5-memcached
* MySQL Server
 * mysql-server
* memcached
* pushpoold
* litecoind

Installation
============

Please ensure you fullfill the minimal installation requirements listed above
and install any missing packages or software.

Download Source
---------------

Download the (stable) master branch from Github:

```
git clone -b master git://github.com/TheSerapher/php-mmcfe-ng.git mmcfe-ng
```

Or, if you are not using git, use the ZIP file provided:

```
wget https://github.com/TheSerapher/php-mmcfe-ng/archive/master.zip
unzip master.zip
mv php-mmcfe-ng-master mmcfe-ng
```

Permissions
-----------

Please ensure your webuser (e.g. `www-data`, `apache`) has write access to
the `mmcfe-ng/public/templates/compile` folder! Otherwise compiled
templates can not be stored:

```
sudo chown www-data mmcfe-ng/public/templates/compile
```

Apache2 Configuration
---------------------

Please point your website document root to the `mmcfe-ng/public` folder
and enable auto-index for `index.php`.

Memcache
--------

Please install and start a default memcache instance. Not only would you
need one for `pushpoold` but the statistics page is storing data in
`memcache` as well to improve performance.

Configuration
-------------

Please create the `mmcfe-ng/public/include/config/global.inc.php`
configuration from the supplied template
`mmcfe-ng/public/include/config/global.inc.dist.php`.

Pushpoold
---------

Please ensure the passwords are read from the proper table by adding this to your configuration:

```
  # database settings
  "database" : {
    "engine" : "mysql",
    "port"    : "3306",
    "name" : "mmcfeng_database_name",
    "username" : "someuser",
    "password" : "somepass",
    "sharelog" : true,
    "stmt.pwdb":"SELECT `password` FROM `workers` WHERE `username` = ?",
    "stmt.sharelog":"INSERT INTO shares (rem_host, username, our_result, upstream_result, reason, solution) VALUES (?, ?, ?, ?, ?, ?)"
  },

```

Database
========

Now that the software is ready we need to import the database.
You will find the SQL file in the `mmcfe-ng/sql` folder.
Import this file into an existing database and you should
have the proper structure ready.

TODO
====

I tried to cover most features available in mmcFE. There might be some missing still
(like graphs, some stats) but if you figure there is a core function missing please let
me know by creating an [Issue][1] marked as `Feature Request`.

Disclaimer
==========

This is a *WIP Project*. Most functionality is now added, the core
features are available and the backend cronjobs are working. If you
encounter any problems related to the code please create a new [Issue][1]

  [1]: https://github.com/TheSerapher/php-mmcfe-ng/issues "Issue"