MPOS stands for Mining Portal Open Source. Issue tracker is now closed since it's not maintained anymore.

Go to file

xisi e7bace5550 basic logging, adds logs folder to root dir htaccess to block access to the logs by default, only log warnings simple config check to see if that folder is writable warning if changeNoFee is used warning if setLocked is used warning if changeAdmin is used warning if when logging in that IP is different than saved IP info if a login fails with bad user or password warning if a user is locked via failed logins info if an update/etc fails with bad pin warning if a user is locked via failed pins info when a pin request is sent warning when a pin request email doesn't send warning when trying to request pin reset and incorrect password info when a twofactor token sent warning if twofactor email doesn't send warning when a user tries to request multiple of the same type of token info when a twofactor token is deleted warning if a twofactor token fails to delete warning when an invalid change password token is used info on successful account update warning when reset password is called and IP doesn't match saved IP, info otherwise warning if isAuthenticated falls through and kills a session		2014-01-31 13:11:38 -05:00
cronjobs	fixed crons, tested on 2 boxes	2014-01-29 18:33:34 -05:00
logs	basic logging, adds logs folder to root dir	2014-01-31 13:11:38 -05:00
public	basic logging, adds logs folder to root dir	2014-01-31 13:11:38 -05:00
scripts	[ADDED] Mark locked accounts during validation	2014-01-07 09:53:26 +01:00
sql	updated expiration on email confirm tokens to 1 hour rather than 10 min	2014-01-20 04:42:08 -05:00
tests	changes DEBUG SALT and SALTY from defines to variables	2014-01-29 07:34:50 -05:00
.gitignore	basic logging, adds logs folder to root dir	2014-01-31 13:11:38 -05:00
.htaccess	basic logging, adds logs folder to root dir	2014-01-31 13:11:38 -05:00
CHANGELOG.md	updated documentation and changelog	2013-05-09 12:18:53 +02:00
CONTRIBUTING.md	[MAJOR] Changing project name to MPOS	2013-10-07 10:10:49 +02:00
LICENSE	initial import of file base of my WIP	2013-05-06 14:11:38 +02:00
README.md	Update README.md	2014-01-27 10:48:16 +01:00

README.md

Description

MPOS is a web based Mining Portal for various crypto currencies. It was created by TheSerapher and has hence grown quite large. Recently it was migrated into a Github Organization to make development easier. It's a community driven open source project: If you wish to participate contact the team on IRC: https://webchat.freenode.net/?channels=#mpos-dev

NOTE: This project is still under development and commits are happening on a daily basis. I do not recommend using this for a live setup as of yet. Wait for the later Release Candidate if you wish to run your pool with it. Testing pools are much appreciated though!

Donations

Donations to this project are going directly to TheSerapher, the original author of this project:

LTC address: Lge95QR2frp9y1wJufjUPCycVsg5gLJPW8
BTC address: 1HuYK6WPU8o3yWCrAaADDZPRpL5QiXitfv

Website Footer

When you decide to use MPOS please be so kind and leave the footer intact. You are not the author of the software and should honor those that have worked on it. I don't mind changing the LTC donation address at the bottom, but keep in mind who really wrote this software and would deserve those ;-).

Donors

These people have supported this project with a donation:

Pools running MPOS

You can find a list of active pools here.

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).

Be aware that MPOS is only for pooled mining. Solo Mining is not supported. They will never match an upstream share, solo miners do not create any shares, only blocks. Expect weird behavior if trying to mix them. See #299 for full information.

64 bit system
Otherwise some coins will display wrong network hashrates
Apache2
libapache2-mod-php5
PHP 5.4+
php5-json
php5-mysqlnd
php5-memcached
php5-curl
MySQL Server
mysql-server
memcached
stratum-mining
litecoind

Features

The following feature have been implemented so far:

Fully re-written GUI with Smarty templates
Full file based template support
NEW SQL based templates
Mobile WebUI
Scrypt, SHA256, VARDIFF Support
Reward Systems
Propotional, PPS and PPLNS
New Theme
Live Dashboard
AJAX Support
Overhauled API
Web User accounts
Re-Captcha protected registration form
Worker accounts
Worker activity
Worker hashrates
Pool statistics
Block statistics
Pool donations, fees and block bonuses
Manual and auto payout
Transaction list
Admin Panel
Cron Monitoring Overview
User Listing including statistics
Wallet information
User Transactions
News Posts
Pool Settings
Templates
Pool Workers
User Reports
Template Overwrite
Notification system
IDLE Workers
New blocks found in pool
Auto Payout
Manual Payout
User-to-user Invitation System
Support for various coins via config
All scrypt coins
All sha256d coins

Installation

Please take a look at the Quick Start Guide. This will give you an idea how to setup MPOS.

Customization

This project was meant to allow users to easily customize the system and templates. Hence no upstream framework was used to keep it as simple as possible. If you are just using the system, there will be no need to adjust anything. Things will work out of the box! But if you plan on creating your own theme, things are pretty easy:

Create a new theme folder in public/templates/
Create a new site_assets folder in public/site_assets
Create your own complete custom template or copy from an existing one
Change your theme in the Admin Panel and point it to the newly created folder

The good thing with this approach: You can keep the backend code updated! Since your new theme will never conflict with existing themes, a simple git pull will keep your installation updated. You decide which new feature you'd like to integrate on your own theme. Bugfixes to the code will work out of the box!

Other customizations are also possible but will require merging changes together. Usually users would not need to change the backend code unless they wish to work on non-existing features in MPOS. For the vast majority, adjusting themes should be enough to highlight your pool from others.

In all that, I humbly ask to keep the MPOS author reference and Github URL intact.

There are a few other projects out there that take advantage of MPOS and it's included API. Here a quick list that you can check out for yourself:

MPOS IRC Bot written in Python, standalone bot, using the MPOS API
MPOS Eggdrop Module written in TCL, adding MPOS commands to this bot, using the MPOS API
Windows Phone Pool App
iPhone iMPOS App

Contributing

You can contribute to this project in different ways:

Report outstanding issues and bugs by creating an Issue
Suggest feature enhancements also via Issues
Fork the project, create a branch and file a pull request to improve the code itself

Contact

You can find the team on Freenode.net, #MPOS.

Team Members

Author and Github Owner: TheSerapher aka Sebastian Grewe

Developers:

License and Author

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.