User Tools

Site Tools


software-addons:softaculous:smf-install

Installing SMF via Softaculous

Difficulty
Easy
Easy

Softaculous can make a useful way of installing software for creating websites, and for helping to keep the installed software updated. Among the things that can be installed in this way is SMF.1)

Although installing SMF via Softaculous does not require a Premium Softaculous license, there are many scripts that do. Thus, you may want to consider having the Premium license installed in case your users want to install any of the scripts that require it. If you do not yet have a Premium license for Softaculous, you can purchase one via our Billing Department.

Note that SMF version 2.0.12 might not work correctly with php 7.X. You may need to use php 5.6 instead.

Step 1: Make sure SMF is available for installation

First, log into WHM and make sure SMF is one of the scripts being made available to the cPanel users for installation. To do this, log into WHM and go to Plugins → Softaculous Instant Installs".

Then within the Softaculous frame's left sidebar, go to "Software → General Scripts".

Then make sure SMF is enabled there. To save time later, you can also check the box in the Pre-Download column.

After checking that the boxes are checked, scroll back up to the top of the list to click the "Update Settings" button.

You should then see the success message:

Step 2: Create the cPanel account

If you haven't already, you will need to make the cPanel account for the site. This is done in WHM under "Create a New Account". If you aren't already sure how to do this, you can read more about some of the first steps to getting a cPanel account set up here.

Step 3: Install SMF

After logging in to the cPanel, scroll down to section "Softaculous Apps Installer". In the subsection "Scripts", one of the options should be "SMF".

Then click the "Install Now" button.

Fill in the information in the form. The first three blanks are for determining the url of the main page of the site. The first dropdown box is to specify if you want to use https or plain http, and whether you want "www." as part of the url or not. The second dropdown box chooses which of the domains or subdomains in the cPanel account to use for the site (in case the cPanel account has more than one). The third box is to type the folder name of the site, in case you don't want it directly under the domain's documentroot. You can also name the board, give it an email address, and choose how bot-resistant to make the visual verification image.

You will also need to specify the username and password you would like to use for the administrative account in the new SMF site. Be very sure to choose a strong password! This is also where you can specify the "Real Name" and contact email address of the site administrator, and the language for the interface. There is also an expandable list of Advanced Options.

Within the Advanced section, you can choose the Database Name and/or Table Prefix, if desired. If WHM has "Require a username prefix on names of new databases and database users" enabled in "Tweak Settings", you do not need to add the prefix yourself.2) It is not recommended to check the box for "Disable Update Notifications". These notifications are very useful to let you know when the site needs updated. It is extremely important that whenever updates are available that they be applied as quickly as possible, in case there are important security patches included in the newer versions. If needed, you can also enable softaculous-level backups of the site, but it is recommended instead to use the automatic backups builtin to WHM. If you do enable the Softaculous-level backups, be sure to enable the backup rotation for a finite number of retained backups. Do not choose unlimited here! Once you have chosen the desired settings, click the Install button at the bottom of the page. If desired, you can first enter your email address in the box below the button, to have Softaculous email you details about the installation.

After clicking "Install", there will briefly be a progress bar as Softaculous checks the validity of the information you entered into the form. If it worked, you should soon thereafter see the success page.3)

If you choose to have Softaculous send you an email with the installation information, it should look something like this:

Return-path: <[email protected]>
Received: from smf by host.XXXXX.net with local (Exim 4.87)
        (envelope-from <[email protected]>)
        id 1c4zmX-0000Qy-1x
        for [email protected]; Thu, 10 Nov 2016 19:33:25 -0500
To: [email protected]
Subject: New Installation of SMF
X-PHP-Originating-Script: 0:mail_functions.php
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
From: Softaculous <[email protected]>
Reply-To: [email protected]
X-Mailer: PHP/5.6.20
Message-Id: <[email protected]>
Date: Thu, 10 Nov 2016 19:33:25 -0500

A new installation of SMF 2.0.12 has been completed. The details of the installation are shown below:
Path : /home/smf/public_html/smf
URL : http://smftest.XXXXX.net/smf
Admin URL : http://smftest.XXXXX.net/smf/index.php?action=admin
Admin Username : hopefullysomethingnotobvious
Admin Password : ********
Admin Email: [email protected]
MySQL Database : smf_smf570
MySQL DB User : smf_smf570
MySQL DB Host : localhost
MySQL DB Password : ********
Update Notification : Enabled
Auto Upgrade : Disabled
Automated Backups : Disabled
Time of Installation : November 11, 2016, 12:33 am

If you wish to unsubscribe from such emails, go to your Control Panel -> Softaculous -> Email Settings

Step 4: First Login

Once the site has been installed, you can then log into the newly-installed site.

Once logged in, you can check some of the site-level configuration, or jump right in with adding some users!

1)
Simple Machines Forum
2)
In this case, the database name would be required to start with the first eight letters of the cPanel username, followed by an underscore, but Softaculous will prepend that for you.
3)
Note that you are not required to Tweet about your new SMF installation, since at this point the site is already installed.
software-addons/softaculous/smf-install.txt · Last modified: 2017/11/09 19:16 by Daniel P.