Vanilla is a powerfully simple discussion forum you can easily customize to make as unique as your community.
PHP JavaScript HTML CSS Smarty Shell
Switch branches/tags
Latest commit a7401cc Apr 24, 2017 @initvector initvector committed on GitHub Merge pull request #5423 from vanilla/fix/format-parsing-order
Simplify parsing orders in formatters
Failed to load latest commit information.
applications Merge pull request #5455 from vanilla/fix/moderation-count Apr 20, 2017
build Do not add liscenes from bower components and node modules Oct 31, 2016
cache Revert "Removed composer and cache from git." Sep 12, 2016
conf Merge branch 'master' of into feature/stub… Mar 6, 2017
js Merge branch 'master' of Mar 2, 2017
library Merge pull request #5423 from vanilla/fix/format-parsing-order Apr 24, 2017
locales Remove execute permissions on all files (chmod -x) Jun 4, 2015
plugins Merge pull request #5448 from vanilla/docs/dtw-lax Apr 19, 2017
resources Check for the existence of deleted files at /utility/upgrade endpoint Feb 17, 2017
tests Merge pull request #5445 from vanilla/feature/unit-test-improvements-2 Apr 20, 2017
themes Added class to target “Powered by Vanilla” text in footer Apr 13, 2017
uploads Remove execute permissions on all files (chmod -x) Jun 4, 2015
.editorconfig Tweak to scss-lint. Dec 18, 2015
.gitattributes Revert 6d0a70e Nov 6, 2015
.gitignore Exclude directory content not the directory itself! (#5285) Mar 4, 2017
.htaccess.dist Rename .htaccess to .htaccess.dist Oct 27, 2016
.travis.yml Update travis setup proces Apr 19, 2017 Remove execute permissions on all files (chmod -x) Jun 4, 2015 Rounded badges from issuestats to keep them consistent Apr 6, 2017
bootstrap.php Merge pull request #5349 from vanilla/feature/cors Mar 30, 2017
composer.json Update garden-schema version requirements Mar 17, 2017
composer.lock Update garden-schema version requirements Mar 17, 2017
container.html Drop attribute "type" for style tags Nov 16, 2016
index.php Bumb Vanilla's version Mar 29, 2017
login.php Fix root file casing Nov 6, 2015
phpunit.xml.dist Add APIv2 tests to the default test suite and fix the build Apr 11, 2017
register.php Fix root file casing Nov 6, 2015
showpost.php Replace dirname(__FILE__) with __DIR__ Mar 30, 2017
showthread.php Scrutinizer Auto-Fixes Apr 9, 2016
viewtopic.php Replace dirname(__FILE__) with __DIR__ Mar 30, 2017

Vanilla uses Composer! You cannot clone this repo right into a web directory - it requires a build step. Learn more or just download the latest stable build instead.


Build Status PR Stats Issue Stats

Howdy, Stranger!

Vanilla was born out of the desire to create flexible, customizable, and downright entertaining community solutions. Vanilla has been used to power tens of thousands of community forums around the world and we couldn't be happier if you've decided to use Vanilla to grow yours.

Every community is unique. Vanilla is a finely-crafted platform on which designers and developers can build a custom-tailored environment that meets your community's particular needs.

5 reasons Vanilla is the sweetest forum

  1. We've reimagined traditional forums for mass-appeal.
  2. Our theming flexibility is second-to-none.
  3. Impossibly good integration options with single sign-ons and embedding.
  4. The best tools available for community management.
  5. Curated features with great plugin options, not the kitchen sink.

Open Source

Vanilla is free, open source software distributed under the GNU GPL2. We accept and encourage contributions from our community and sometimes give hugs in return. You can join us on the Vanilla Community Forums to be part of that discussion.

The latest stable release is always listed here. Currently, it is the release/2.3 branch.

New plugins and themes can be listed in the Official Addon Directory. We encourage addon developers to release their code under the GPL as well, but do not require it.

Cloud Solution

Vanilla Forums provides an official cloud hosting solution at with a 1-click install, automatic upgrades, amazing professional support, incredible scalability, integration assistance, theming and migration services, and exclusive features. For the very best Vanilla forum experience, you can skip the rest of this technical stuff and go there directly.

If you professionally run a large community or enterprise forum, our cloud solution will make the best technical and economic sense by far.

Self-Hosting Requirements

We strongly recommend:

  • PHP 7.0 or higher.
  • MySQL 5.6 or higher (or Percona/MariaDB equivalent).

If your server is not running PHP 7.0 or higher, you should address this soon. While PHP 5.6 will receive security patches thru 2018, Vanilla may end support for it prior to that.

Our minimum requirements are now:

  • PHP 5.6 or newer.
  • PHP extensions mbstring (--enable-mbstring), cURL (--with-curl), and PDO (on by default).
  • To import into Vanilla you need MySQLi (--with-mysqli).
  • To use our social plugins you need OpenSSL.
  • MySQL 5.0 or newer (or Percona/MariaDB equivalent).

Vanilla ships with a .htaccess file required for Apache support. Using nginx or IIS may require additional configuration.

On the client side, Vanilla should run & look good in just about any modern browser. Still using IE? How exotic. You'll want IE8 or greater. IE7 might work if you squint hard and click gently, but we make no promises.

We've been natively mobile since before it was cool. Vanilla ships with a mobile-optimized theme enabled by default for all smartphones & tablets. Heck, it even works on the PlayStation Vita.


Vanilla is built to be simple, and its installation is no exception.

  • Upload Vanilla's pre-built version to your server.
  • Confirm the cache, conf, and uploads folders are writable by PHP.
  • Navigate to that folder in your web browser.
  • Follow the instructions on screen.


Follow these steps to upgrade Vanilla when a new stable release is announced.

Please consider using maintenance mode before running database updates if your database is very large (millions of users or discussions).

  • Backup your database, .htaccess and conf/config.php file somewhere safe.
  • Upload the new release's files so they overwrite the old ones.
  • Delete all files in /cache.
  • Go to to run any database updates needed. (404? See next paragraph.) If it fails, try it a second times by refreshing the page.
  • If any "Deleted Files" are listed on the upgrade page, manually delete the listed files.

If your forum still uses URLs including ?p=:

Support for this URL structure is ending after 2.3 in favor of "pretty" URLs so it's time to make the switch. First, confirm your server is setup to handle rewrites. On Apache, using the .htaccess file provided will accomplish this. Additional setup is required on nginx and other platforms. Test whether it is working by visiting /discussions - if you see a discussions list (rather than a 404), it is likely setup correctly. Then, open conf/config.php and find the line with $Configuration['Garden']['RewriteUrls'] = false; and delete the entire line. Your site should immediately switch to "pretty" URL paths instead of using the 'p' parameter. If there is a problem, re-add the line to your config and do further troubleshooting.

To upgrade from 2.1 or earlier:

  • Update any locales you have installed (their name format changed in 2.2). Verify they are working after upgrade.
  • Apache users must update their .htaccess file.
  • Delete these files from your server if they exist: /themes/mobile/views/discussions/helper_functions.php and /applications/dashboard/views/default.master.php

To upgrade from Vanilla 1.0 requires a full migration (see next section). Themes and plugins are not compatible. Backup your Vanilla 1 data and files completely, then delete them from your server before attempting to install Vanilla 2.

Migrating to Vanilla

  • Get Vanilla Porter and verify it supports your platform.
  • Read the Advanced Uses notes on that page.
  • Upload it to your current server.
  • Navigate to the file in your web browser & run it.
  • Take the file it produces and import it to Vanilla.

Getting Help


  • Troubleshoot issues you run into on the community forum so everyone can help & reference it later.
  • Got an idea or suggestion? Use the forum to discuss it.
  • File detailed issues on GitHub (version number, what you did, and actual vs expected outcomes).
  • Sign the Contributors' Agreement to send us code.
  • Use pull requests against the master branch.
  • Keep our to-do list fresh by reviewing our open issues for resolved or duplicated items.

Building with Phing

Vanilla includes a buildfile for Phing, a build system for PHP, in the build directory. Running the phing command from the build directory will create a deploy-ready copy of Vanilla. This process automatically fetches dependencies with Composer, filters out any unnecessary developer files (Git files/directories, .editorconfig, unit tests, etc.) and compresses the result into an archive.

Version Control Strategy

We've adopted the git flow branching model in our projects. The creators of git flow released a short intro video to explain the model.

The master branch is production-ready for our cloud product but is not yet vetted for open source release (alternate platforms & configurations). Reviewed, stable changes land against master via pull-request.

Our open source release branches are named by version number, e.g. release/2.3. We begin release branches with a beta (b1) designation and progress them thru release candidate to stable. All open source releases (included pre-releases) are tagged.

Reporting Security Issues

Please disclose security issues responsibly by emailing with a full description. We'll work on releasing an updated version as quickly as possible. Please do not email non-security issues; use the issue tracker instead.

Legal Stuff

Copyright © 2009-2017 Vanilla Forums Inc.

Vanilla Forums is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version. Vanilla Forums is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with Vanilla Forums. If not, see Contact Vanilla Forums Inc. at support [at] vanillaforums [dot] com


Just kidding, everything's awesome. dance