ElkArte Forum. A free, open source, PHP-based discussion forum.
PHP JavaScript CSS Other
Latest commit 2d6148f Nov 7, 2017 @emanuele45 emanuele45 Merge pull request #2987 from live627/refactor/theme
Refactor theme objects
Failed to load latest commit information.
addons I think the addons directory is missing from the repo Jan 2, 2016
attachments ! whitespace removal Apr 29, 2014
avatars ! remove trailing newline Dec 27, 2013
cache cache gitignore Jan 30, 2017
docs ! default font, good for black ?'s instead of nothing Sep 27, 2016
install Updated the constants for 1.1 final Oct 15, 2017
packages ! few more extra newlines removed Dec 21, 2013
release_tools Changed headers to 1.1 final Oct 15, 2017
smileys ! few more extra newlines removed Dec 21, 2013
sources Update Errors.php Nov 1, 2017
tests fix tests Oct 28, 2017
themes rename stray instance getters Oct 30, 2017
.gitattributes ! dont convert line endings on the phar file Oct 14, 2014
.gitignore db_last_error has changed from php to txt Feb 3, 2017
.travis.yml New error type: deprecated Oct 27, 2017
CONTRIBUTING.md Remove the sign-off requirement for contributions Jul 31, 2014
LICENSE.txt 2017 Preparation Update Dec 30, 2016
README.md Update README.md Jun 29, 2016
SSI.php Refactor theme objects Oct 27, 2017
Settings.sample.php Removed copyrights from the Settings files and added some spacing bet… May 1, 2015
Settings_bak.sample.php Removed copyrights from the Settings files and added some spacing bet… May 1, 2015
agreement.txt Amended missing newlines Oct 12, 2016
bootstrap.php I identify as an attack helicopter Oct 27, 2017
composer.json ! update testbed Jun 30, 2017
db_last_error.sample.txt The less the writable php files we have, the better: db_last_error is… Jul 2, 2014
email_imap_cron.php Changed headers to 1.1 final Oct 15, 2017
emailpost.php Changed headers to 1.1 final Oct 15, 2017
emailtopic.php Changed headers to 1.1 final Oct 15, 2017
favicon.ico Elky favicon Oct 20, 2013
index.php Reuse is the best form of recycling Oct 28, 2017
license.md 2017 Preparation Update Dec 30, 2016
ssi_examples.php Changed headers to 1.1 final Oct 15, 2017
ssi_examples.shtml 2017 Preparation Update Dec 30, 2016
subscriptions.php Refactor theme objects Oct 27, 2017



This is the ElkArte repository.

ElkArte is a modern, free, powerful community building forum software. It is completely free and licensed with an open source BSD 3-clause license.

Initially based on Simple Machines Forum (SMF), it began as an overhaul of the code; to modernise, implement new features and make a forum software more relevant in a time of unprecedented social interaction. It has grown to become a modern and feature rich forum package to meet the demands of today's message board user.

Enjoy the benefits of enthusiasts from around the world who spend time making ElkArte what it is today.

Test ElkArte yourself by visiting ElkArte.net.

Contributions to documentation are licensed under CC-by-SA 3. Third party libraries or sets of images, are under their own licenses.

Build Status Open Issues Current Release License

A small taste of new ElkArte features

  • @Mentioning users including notifications
  • Likes for posts and topics
  • Drafts, including auto save
  • OpenID 2.0 (BC Math must be available)
  • Two built in modern, responsive themes
  • Integrated video embedding for youtube, vimeo and dailymotion
  • Drag and drop ordering in the administration interface
  • Drag and drop file attachments
  • Improved Anti Spam measures
  • Improved password hashing using industry standards
  • Bad Behaviour built in
  • Automatic combining and minifying of JavaScript and CSS
  • Posting by Email
  • Ajax previews and responses throughout the user interface
  • Utilizes jQuery and Font Awesome


  • PHP version 5.3 or newer
  • MySQL 5 and newer OR PostgreSQL 8.3 and newer

On the client side, ElkArte will run & look good with its responsive theme in just about any modern browser, smartphone or tablet.

Setting up an ElkArte Forum:

If you're not here to play with the open source code, but instead would like to set up an ElkArte forum, follow these steps. Since ElkArte is built to be simple to use, its installation is no exception.

  • Create a database for your forum using a tool like PHPMyAdmin
  • Get the latest Install Package for ElkArte.
  • Upload and extract the entire file structure up to your web server.
  • Confirm the folders are writable by PHP.
  • Navigate to that folder in your web browser
  • Follow the instructions on screen.
  • Enjoy !

Migrating to ElkArte

Switching to ElkArte is fast and easy!

Simply install ElkArte using our Quick Installer (as outlined above), then utilizing the Open Importer Engine you can migrate to ElkArte from many other popular forums including SMF, phpBB, MyBB, vBulletin, XenForo and more.

Extend ElkArte

ElkArte was built to be extensible, so you can add new features or give it your own custom look, with ease. With 100's of plugin hooks, adding new features can be done without any involved source edits.

Browse the collections of Themes and Addons created by our awesome community


  • Troubleshoot issues you run into on the ElkArte community forum so others can help & the developers can reference it later.
  • Have a new feature idea or improvement suggestion? Use the forum to discuss it.
  • File detailed issues on GitHub (what you did, and what the actual vs expected outcomes are).
  • Read the Developer's Certificate of Origin if you want to send us code. It means you acknowledge that you can and do license your submissions under the license of the project.
  • Feel free to fork this repository and make your desired changes.

Please see our How to contribute section for more information on how to contribute to the ElkArte Project.

Class / Method / Function documentation

ElkArte utilizes inline docblocks to provide descriptions for all of its classes, methods and functions. This API Documentation is available online for viewing and searching.

Site and IRC

Join us on IRC, on #elkarte channel on freenode.

Project site: www.elkarte.net