Bored?  Looking to kill some time?  Want to chat with other SMF users?  Join us in IRC chat or Discord

Main Menu

Installation Guide

Started by Ben_S, March 06, 2004, 08:40:55 PM

Previous topic - Next topic


For an updated version of this guide read the installation tutorial on the doc site

SMF 1.0 Installation Guide

Before you decide to install the SMF beta, you MUST take into account the following

1. Keep in mind that SMF is still in beta.  While this version has been tested by many people, it is still in the beta testing phase.  This means it may still have bugs, and should not be used in production unless you are willing to accept slight bugs..  Please also remember that the installer should be going through a redesign later in the development process.

2. Check the minimum requirements. To save any headaches down the line, you should ensure that the server you intend to install SMF on meets the following requirements:

Client Requirements
  - at least Microsoft Internet Explorer 4.0 for Windows, Opera 7, Mozilla 1.0.2, Netscape 6.0, Safari 1.0, Konqueror, or Galeon for proper functionality.
  - Opera 6 may work, but full functionality is not guaranteed.
  - Javascript enabled for many functions.

Server Requirements
  - Any webserver that supports PHP properly, such as Apache or Internet Information Services (IIS).
  - PHP 4.1.0 or higher.  The following are required to be set correctly in php.ini:
     - the engine directive must be On.
     - the magic_quotes_sybase directive must be set to Off.
     - the session.save_path directive must be set to a valid directory.
     - the session.use_only_cookies must be off for proper session handling if cookies are not enabled.
     - the file_uploads directive must be On.
     - the upload_tmp_dir must be set to a valid directory.
  - MySQL 3.23.4 or higher.
     - at least 500 kilobytes of storage space in the database, although more is highly recommended.
  - about two and a half megabytes of storage space on the web server. (more for attachments!)

Server Recommendations
  - Linux or another Unix based operating system, as well as the GNU Aspell and its dictionaries, is required by PHP for spell checking functionality.
  - Apache with AcceptPathInfo set to On (Apache 2 and later only.) for queryless URLs.
  - PHP 4.3.0 or higher, with the following set in php.ini:
     - it is recommended that the max_input_time directive is set to a value of at least 30.
     - it is recommended that the post_max_size and upload_max_filesize directives are set to the size of the largest attachments you wish to be able to upload.
     - it is recommended that the session.use_trans_sid directive is set to Off.
     - it is recommended that the session.use-cookies directive is set to On.
     - it is recommended that the memory_limit directive is set to at least 8M.
     - it is recommended that the max_execution_time directive is set to at least 15.
     - it is recommended that the register_globals directive is set to Off.
  - MySQL 4.0.15 or higher..
  - GD 2.0 or higher.

Obtaining SMF

You can download the latest beta from the download page on the official Simple Machines website.

There are a number of packages available, as this guide covers fresh installs, you should download one of the "install" packages as these contain all the files needed to get up and running. We suggest you download the zip option as this is most common and therefore you are more likely to have the tools required to unzip it already installed on your computer.

Unzip the package, ensuring you keep the directory structure, if you are using Windows XP, the easiest way is to right click on the file you downloaded and select the "extract all" option and follow the wizard. If you are using another operating system, then use winzip or a similar programme.

Uploading SMF

You should now be at the stage where you can upload the SMF files to your server. Initiate an FTP connection to the server and create a directory on the server, you can name the directory anything you like but SMF is a good choice.

Now you want to upload the SMF files to the directory you have just created so navigate to the directory in your FTP program and open up the folder that you unzipped the SMF packaged to in Windows Explorer. Select all the files and folders and copy them [goto edit > copy] and in your ftp program paste them. The files should now be uploading and, depending on the speed of your internet connection, this may take some time.

After uploading the files go to www.yourdomain.tfl/smf/install.php (or the directory name you choose).
If the first page comes up with a dialog requesting FTP information this is because you are running on a *nix server. At this stage just enter in your ftp details and the install program will attempt to set permissions on your server accordingly. If however you wish to do this manually or this initial step fails simply connect to your server with a piece of ftp software and change the permissions on the following files and directories to 777. On most client software this is achieved by right clicking on the files you wish to change and typing in the number.

The following files need to be CHMOD'ed to 777.

  • attachments
  • avatars
  • Packages
  • Packages/installed.list
  • Packages/server.list
  • Smileys
  • Themes
  • agreement.txt
  • Settings.php
  • Settings_bak.php
  • install.php
  • Themes/default/languages/Install.english.php

Installing SMF

Assuming the previous steps went well, you should now have the SMF source files on your server and their relevant permissions set, all that is needed now is to run the install.php file to configure your MySQL database, settings and your admin account.

Open up your favourite web browser and browse to http://www.yourdomain.tld/smf/install.php (where smf is the directory name you chose earlier). Provided you set the permissions correctly on Settings.php and Setting_bak.php you should see a form asking for various settings. Fill these in as follows:

Forum Name: This will be the name of your forum.  It starts as "My Community" but you should probably change it.
Forum URL: This is the url your forum will be located at, the SMF installer should have worked this out for itself so in most cases you can leave this setting at its default value.
MySQL server name: This is where we specify the server that the MySQL database resides on. 99% of the time this will be localhost.
MySQL username: This is the username for your MySQL database, often you will have to set this up in your web hosts control panel, if in doubt, consult your host.
MySQL password: This is the password for your MySQL database, often you will have to set this up in your webhosts control panel, if in doubt, consult your host.
MySQL Database name: This is the name of your MySQL database, often you will have to set this up in your webhosts control panel, if in doubt, consult your host.
MySQL Database prefix: This is a prefixed to the table names in your database, it enables you to run more than one application on a single MySQL database, you should generally leave it as smf_, unless you are installing a second copy of SMF on the same database.

Once you have filled in all of the settings, click on proceed, you should see a lot of information and the word successful on each line scroll to the bottom of the page and click proceed again.

You will now be asked for details of your admin account, this will create your username on the forum. As a security measure, you are also asked for your database password. Once you have filled in the form, click on proceed.

Your forum is now installed and you can proceed to your forum, however, before doing so, it is VERY IMPORTANT that you delete the install.php file from the server as leaving it there is a major security risk. To do so return to your ftp program in the directory you installed SMF to, locate install.php, select it, and hit delete.

Congratulations, we hope you enjoy using SMF, if you have any support questions, feel free to ask them in our support forum.

The Simple Machines Team
Liverpool FC Forum with 14 million+ posts.


Andrea Hubacher
Ex Lead Support Specialist

Personal Signature:
Most recent work:
10 Aqua Themes for SMF



Explanation in Indonesian language...? From Thread ups there...!



ok i got stuck at uploading and ive never done this before so i dont know how to make a smf please help me i have no idea wat and ftp connection is and so i dont know how to connect and what server omg plz help im so confused...

dont flame me!


 :D Have you sorted out a hosting account? That's the first step. You wont get flamed here anyway.

If you have a hosting account, does it let you have cpanel?

solidghost [nonactive]

A step by step tutorial on how to setup the SMF forum script. [nonactive] | [nonactive] | [nonactive]


"An important reward for a job well done is a personal sense of worthwhile achievement."

[ Themes ]