1[](https://e107.org) 2================= 3 4[](https://github.com/e107inc/e107/releases) 5[](https://github.com/e107inc/e107/actions) 6[](https://codeclimate.com/github/e107inc/e107/test_coverage) 7[](https://gitter.im/e107inc/e107?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) 8 9**[e107][1]** is a free and open-source content management system (CMS) which allows you to manage and publish your content online with ease. Developers can save time in building websites and powerful online applications. Users can avoid programming completely! Blogs, websites, intranets – e107 does it all. 10 11## Table of Contents 12 13 * [e107 Content Management System](README.md) 14 * [Table of Contents](#table-of-contents) 15 * [Requirements](#requirements) 16 * [Minimum](#minimum) 17 * [Recommended](#recommended) 18 * [Installation](#installation) 19 * [Standard Installation](#standard-installation) 20 * [Git Installation (developer version)](#git-installation-developer-version) 21 * [Reporting Bugs](#reporting-bugs) 22 * [Contributing to Development](#contributing-to-development) 23 * [Donations](#donations) 24 * [Support](#support) 25 * [License](#license) 26 27## Requirements 28 29 ### Minimum 30 31 * A web server (Apache or Microsoft IIS) running PHP 5.6 or newer 32 * MySQL 4.x or newer, or MariaDB 33 * FTP access to your web server and an FTP client (such as FileZilla) 34 * Username and password to your MySQL database 35 36 ### Recommended 37 38 * Apache 2.2 or newer on Linux with PHP 7.0 or newer 39 * MySQL 5.x or newer, or MariaDB 40 * A registered domain name 41 * Access to a server control panel (such as cPanel) 42 43 44## Installation 45 46### Standard Installation 47 481. [Download e107](https://e107.org/download). 492. Unzip/Extract the compressed file onto your desired web root. 50 This is often a folder called `public_html`. 513. Point your browser to the `install.php` script (e.g., `https://example.com/subfolder/install.php`) 524. Follow the installation wizard in your browser. 53 54 55 56### Git Installation (developer version) 57 581. Run the following commands, replacing '~' with your document root (the parent of `public_html`) and xxx:xxx is the intended owner of your e107 files. 59 ``` 60 cd ~ 61 git clone https://github.com/e107inc/e107.git public_html 62 chown -R xxx:xxx public_html 63 ``` 642. Point your browser to the `install.php` script (e.g., `https://example.com/subfolder/install.php`) 653. Follow the installation wizard in your browser. 66 67 68 69## Reporting Bugs 70 71Be sure you are using the most recent version of e107 prior to reporting an issue. 72You may report any bugs and make feature requests [e107's GitHub Issues page](https://github.com/e107inc/e107/issues). 73 74 75 76## Contributing to Development 77 78* Please submit 1 pull request for each GitHub issue you work on. 79* Make sure that only the lines you have changed actually show up in a file-comparison (diff). 80 Some text editors alter every line; this should be avoided. 81* It is recommended to configure `git pull` to rebase on the master branch by default to avoid unnecessary merge commits. You can set this up in your copy of the repo's `.git/config` file like so: 82 ``` 83 [branch "master"] 84 rebase = true 85 ``` 86* See the [CONTRIBUTING](.github/CONTRIBUTING.md) document for a tutorial on getting started. 87 88## Donations 89If you like e107 and wish to help it to improve, please consider making a small donation. 90 91* PayPal: donate (at) e107.org 92 93 94 95## Support 96* https://e107help.org 97 98 99 100## License 101 102e107 is released under the terms and conditions of the GNU General Public License (http://www.gnu.org/licenses/gpl.txt) 103 104 [1]: https://e107.org
