How to Install Vanilla Forums on Linux Mint

Vanilla Forums is a free and open-source software for building engaging community-driven websites. This tutorial will guide you through the installation process of Vanilla Forums on Linux Mint.

Prerequisites

Before proceeding with the installation, you will need the following:

• A Linux Mint machine with root privileges.
• Apache, MySQL, and PHP installed on the machine.
• Basic knowledge of the command-line interface.

Step 1: Download Vanilla Forum

Download the latest version of Vanilla Forums from the official website "https://vanillaforums.org/". You can download it using your web browser, or using the wget command in the terminal.

$ wget https://open.vanillaforums.com/get/vanilla-core.zip

Step 2: Extract Vanilla Forum

After downloading the Vanilla Forum archive, extract it in the desired directory using the unzip command.

$ unzip vanilla-core.zip

This will create a new directory named vanilla in the current directory.

Step 3: Configure Apache Web Server

Create a new Apache configuration file for Vanilla Forum using the following command:

$ sudo nano /etc/apache2/sites-available/vanilla.conf

Add the following lines to the file. Make sure to replace example.com with your own domain name or IP address.

<VirtualHost *:80>
    ServerAdmin [email protected]
    ServerName example.com
    DocumentRoot /path/to/vanilla

    <Directory /path/to/vanilla>
        Options FollowSymLinks
        AllowOverride All
        Require all granted
    </Directory>

    ErrorLog /var/log/apache2/example.com_error.log
    CustomLog /var/log/apache2/example.com_access.log combined
</VirtualHost>

Save and close the file using Ctrl+X, Y. Then enable the newly created configuration file with the command:

$ sudo a2ensite vanilla.conf

Restart the Apache webserver to apply the changes:

$ sudo systemctl restart apache2

Step 4: Create MySQL Database

Create a new MySQL database and user for Vanilla Forum using the following commands:

$ sudo mysql -u root -p
mysql> CREATE DATABASE vanilla_db;
mysql> CREATE USER 'vanilla_user'@'localhost' IDENTIFIED BY 'password123';
mysql> GRANT ALL PRIVILEGES ON vanilla_db.* TO 'vanilla_user'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> EXIT;

Make sure to replace vanilla_db, vanilla_user, and password123 with your own database name, username, and password.

Step 5: Configure Vanilla Forum

Rename the conf/config-sample.php file to conf/config.php in the Vanilla Forum directory:

$ mv conf/config-sample.php conf/config.php

Edit the conf/config.php file using a text editor:

$ nano conf/config.php

Update the following parameters in the file:

• $Configuration['Database']['Host'] = 'localhost';
• $Configuration['Database']['Name'] = 'vanilla_db';
• $Configuration['Database']['User'] = 'vanilla_user';
• $Configuration['Database']['Password'] = 'password123';
• $Configuration['Garden']['Title'] = 'My Vanilla Forum';
• $Configuration['Garden']['WebRoot'] = 'http://example.com/';

Save and close the file using Ctrl+X, Y.

Step 6: Install Vanilla Forum

Open your web browser and navigate to your Vanilla Forum installation URL (http://example.com/ in our example). Follow the installation wizard steps to complete the installation process.

Conclusion

You have successfully installed Vanilla Forum on your Linux Mint machine. You can now customize your forum's appearance, create categories, and manage users to start building a thriving online community.