Howdy, Stranger!

It looks like you're new here. If you want to get involved, click one of these buttons!

Try Vanilla Forums Cloud product
Please upgrade to 2.3 here. The 2.2 and earlier branches are no longer being updated.

Extended How-to install Vanilla 2

edited June 2010 in Vanilla 2.0 - 2.2
Hey all,

I love Vanilla 1 to bits and was keen to try Vanilla 2 but kept running into issues which I could not resolve. I've finally got it up and running with the help of some helpful folk on this forum so I decided to write an extended how-to for Vanilla 2 in case you encounter similar problems to me.

I'd like to reiterate the developers' comments first by saying Vanilla 2 is still in development so you should bear this in mind if you intend on using it on a live site. It could be prone to unexpected bugs/behaviour. If you're unsure/concerned, use Vanilla 1 instead.

Extended How-to install Garden/Vanilla 2

1. Download the latest stable release of Garden from GitHub. What's Garden? It's the platform on which Vanilla runs - but don't fret, Vanilla forum is bundled in with this download.

2. Extract the .zip or .tar and copy the contents into the desired folder on your server. Remember to upload the .htaccess file in the root directory which may not be visible to you if you have these types of files hidden. Most FTP programs have an option to show invisible files if it isn't already set by default.

3. In /conf/config-defaults.php consider uncommenting line 47:
// $Configuration['Garden']['Errors']['MasterView'] = 'deverror.master.php'; // <-- Use this error master view when debugging
This will enable verbose error messages and is very useful when installing and setting up. These messages will help other forum users with diagnosing any problems you encounter. Of course, once happy with your setup, it's recommended to comment out this line once again, so users encounter 'pretty errors'.

4. Grant Read/Write permissions (777) to /cache/, /conf/, and /uploads/
[EDIT] If your server is setup correctly, you shouldn't need to change these permissions - doing so is a security flaw. See the rest of the discussion for more info (thanks to those for highlighting this)

5. Create a database (name does not matter).

6. Browse to your install folder in your web browser, and follow the instructions on-screen.

As I said, if you encounter any errors and have completed step 3, you should have a verbose error - post this and any information about your server (PHP version etc.) and the steps you performed leading up to the error into the community forums.

Hope that helps - thanks to @benno and @bean for their help in getting my install working. I used their advice, my experience and the Documentation to provide the above information.

Good luck!



Sign In or Register to comment.